Merge branch 'develop' into stable

Author: Pathoschild

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>4.1.10</Version>
+    <Version>4.2.0</Version>
     <Product>SMAPI</Product>
     <LangVersion>latest</LangVersion>
     <AssemblySearchPaths>$(AssemblySearchPaths);{GAC}</AssemblySearchPaths>

docs/release-notes.md

@@ -1,6 +1,32 @@
 ← [README](README.md)
 
 # Release notes
+## 4.2.0
+Released 24 March 2025 for Stardew Valley 1.6.14 or later. See [release highlights](https://www.patreon.com/posts/125017679).
+
+* For players:
+  * Fixed `log_context` command not disabling the extra logs when run again.
+  * Fixed update alerts when using an unofficial port of SMAPI with a four-part version number.
+  * Fixed installer on Linux not always opening a terminal as intended (thanks to HoodedDeath!).
+  * Updated compatibility list.
+
+* For mod authors:
+  * Mod events are now raised on the shipping menu (except when it's actually saving).
+  * Added translation API methods to query translation keys (`ContainsKey` and `GetKeys`).
+  * Fixed the game's `Data/ChairTiles` logic not handling unique string IDs like `Maps/Author.ModName` correctly.
+  * Fixed exception thrown if `modRegistry.GetApi<T>` can't proxy the API to the given interface. It now logs an error and returns null as intended.
+
+* For external tools:
+  * Added toolkit method to read the compatibility list from a local copy of its Git repo.
+
+* For the web UI:
+  * You can now link to a mod in the compatibility list by its unique ID, like [smapi.io/mods#Pathoschild.ContentPatcher](https://smapi.io/mods#Pathoschild.ContentPatcher).
+  * Fixed search engines able to index uploaded logs and JSON files via the raw download option.
+  * Improved Content Patcher JSON schema:
+    * Updated for Content Patcher 2.5.0.
+    * Added format validation for token names.
+    * Fixed incorrect error when setting a config default to a boolean or number.
+
 ## 4.1.10
 Released 18 December 2024 for Stardew Valley 1.6.14 or later.
 

src/SMAPI.Installer/InteractiveInstaller.cs

@@ -27,10 +27,7 @@ internal class InteractiveInstaller
     private readonly string BundlePath;
 
     /// <summary>The mod IDs which the installer should allow as bundled mods.</summary>
-    private readonly string[] BundledModIDs = {
-        "SMAPI.SaveBackup",
-        "SMAPI.ConsoleCommands"
-    };
+    private readonly string[] BundledModIds = ["SMAPI.SaveBackup", "SMAPI.ConsoleCommands"];
 
     /// <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>
@@ -207,7 +204,7 @@ public void Run(string[] args)
             Console.WriteLine();
 
             // handle choice
-            string choice = this.InteractivelyChoose("Type 1 or 2, then press enter.", new[] { "1", "2" }, printLine: Console.WriteLine);
+            string choice = this.InteractivelyChoose("Type 1 or 2, then press enter.", ["1", "2"], printLine: Console.WriteLine);
             switch (choice)
             {
                 case "1":
@@ -298,7 +295,7 @@ public void Run(string[] args)
                 this.PrintInfo("[2] Uninstall SMAPI.");
                 Console.WriteLine();
 
-                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.", ["1", "2"]);
                 switch (choice)
                 {
                     case "1":
@@ -447,7 +444,7 @@ public void Run(string[] args)
                             this.PrintWarning($"   ignored invalid bundled mod {sourceMod.DisplayName}: {sourceMod.ManifestParseError}");
                             continue;
                         }
-                        if (!this.BundledModIDs.Contains(sourceMod.Manifest.UniqueID))
+                        if (!this.BundledModIds.Contains(sourceMod.Manifest.UniqueID))
                         {
                             this.PrintWarning($"   ignored unknown '{sourceMod.DisplayName}' mod in the installer folder. To add mods, put them here instead: {paths.ModsPath}");
                             continue;
@@ -709,7 +706,7 @@ private string InteractivelyChoose(string message, string[] options, string inde
         }
 
         // get valid install paths & log invalid ones
-        List<DirectoryInfo> defaultPaths = new();
+        List<DirectoryInfo> defaultPaths = [];
         foreach ((DirectoryInfo dir, GameFolderType type) in this.DetectGameFolders(toolkit, context))
         {
             if (type is GameFolderType.Valid)
@@ -799,7 +796,7 @@ private string InteractivelyChoose(string message, string[] options, string inde
     /// <param name="context">The installer context.</param>
     private IEnumerable<(DirectoryInfo, GameFolderType)> DetectGameFolders(ModToolkit toolkit, InstallerContext context)
     {
-        HashSet<string> foundPaths = new HashSet<string>();
+        HashSet<string> foundPaths = [];
 
         // game folder which contains the installer, if any
         {
@@ -830,28 +827,28 @@ private string[] GetInvalidFolderWarning(GameFolderType type)
         switch (type)
         {
             case GameFolderType.Valid:
-                return new[] { "OK!" }; // should never happen
+                return ["OK!"]; // should never happen
 
             case GameFolderType.LegacyVersion:
-                return new[]
-                {
+                return
+                [
                     "That directory seems to have Stardew Valley 1.5.6 or earlier.",
                     "Please update your game to the latest version to use SMAPI."
-                };
+                ];
 
             case GameFolderType.LegacyCompatibilityBranch:
-                return new[]
-                {
+                return
+                [
                     "That directory seems to have the Stardew Valley legacy 'compatibility' branch.",
                     "Unfortunately SMAPI is only compatible with the modern version of the game.",
                     "Please update your game to the main branch to use SMAPI."
-                };
+                ];
 
             case GameFolderType.NoGameFound:
-                return new[] { "That directory doesn't contain a Stardew Valley executable." };
+                return ["That directory doesn't contain a Stardew Valley executable."];
 
             default:
-                return new[] { "That directory doesn't seem to contain a valid game install." };
+                return ["That directory doesn't seem to contain a valid game install."];
         }
     }
 

src/SMAPI.Installer/assets/install on Linux.sh

@@ -1,13 +1,13 @@
 #!/usr/bin/env bash
 
 function open_in_terminal { # Checks for a few different terminal emulators to launch the installer through
-    if which konsole 2&>1 >/dev/null; then # KDE Konsole
+    if which konsole 2>&1 >/dev/null; then # KDE Konsole
         konsole -e $1
-    elif which alacritty 2&>1 >/dev/null; then # Alacritty
+    elif which alacritty 2>&1 >/dev/null; then # Alacritty
         alacritty -e $1
-    elif which gnome-terminal 2&>1 >/dev/null; then # GNOME Terminal
+    elif which gnome-terminal 2>&1 >/dev/null; then # GNOME Terminal
         gnome-terminal -- $1
-    elif which xterm 2&>1 >/dev/null; then # Xterm
+    elif which xterm 2>&1 >/dev/null; then # Xterm
         xterm -e $1
     else # Use notify-send to send a message that none of these terminals were found installed and instruct the user to manually invoke this script through a terminal
         notify-send --app-name="SMAPI Installer" --urgency=critical "Failed to find a terminal to open installer with. Please use a terminal program to open the 'install on Linux.sh' script"

src/SMAPI.Internal/ConsoleWriting/ColorfulConsoleWriter.cs

@@ -126,18 +126,18 @@ private bool TestColorSupport()
     private IDictionary<ConsoleLogLevel, ConsoleColor> GetConsoleColorScheme(Platform platform, ColorSchemeConfig colorConfig)
     {
         // get color scheme ID
-        MonitorColorScheme schemeID = colorConfig.UseScheme;
-        if (schemeID == MonitorColorScheme.AutoDetect)
+        MonitorColorScheme schemeId = colorConfig.UseScheme;
+        if (schemeId == MonitorColorScheme.AutoDetect)
         {
-            schemeID = platform == Platform.Mac
+            schemeId = platform == Platform.Mac
                 ? MonitorColorScheme.LightBackground // macOS doesn't provide console background color info, but it's usually white.
                 : ColorfulConsoleWriter.IsDark(Console.BackgroundColor) ? MonitorColorScheme.DarkBackground : MonitorColorScheme.LightBackground;
         }
 
         // 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}'.");
+            : throw new NotSupportedException($"Unknown color scheme '{schemeId}'.");
     }
 
     /// <summary>Get whether a console color should be considered dark, which is subjectively defined as 'white looks better than black on this text'.</summary>

src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetCollection.cs

@@ -4,4 +4,4 @@
 namespace Netcode;
 
 /// <summary>A simplified version of Stardew Valley's <c>Netcode.NetCollection</c> for unit testing.</summary>
-public class NetCollection<T> : Collection<T> { }
+public class NetCollection<T> : Collection<T>;

src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetInt.cs

@@ -2,4 +2,4 @@
 namespace Netcode;
 
 /// <summary>A simplified version of Stardew Valley's <c>Netcode.NetInt</c> for unit testing.</summary>
-public class NetInt : NetFieldBase<int, NetInt> { }
+public class NetInt : NetFieldBase<int, NetInt>;

src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetList.cs

@@ -4,4 +4,4 @@
 namespace Netcode;
 
 /// <summary>A simplified version of Stardew Valley's <c>Netcode.NetObjectList</c> for unit testing.</summary>
-public class NetList<T> : List<T> { }
+public class NetList<T> : List<T>;

src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetObjectList.cs

@@ -2,4 +2,4 @@
 namespace Netcode;
 
 /// <summary>A simplified version of Stardew Valley's <c>Netcode.NetObjectList</c> for unit testing.</summary>
-public class NetObjectList<T> : NetList<T> { }
+public class NetObjectList<T> : NetList<T>;

src/SMAPI.ModBuildConfig.Analyzer.Tests/Mock/Netcode/NetRef.cs

@@ -2,4 +2,4 @@
 namespace Netcode;
 
 /// <summary>A simplified version of Stardew Valley's <c>Netcode.NetRef</c> for unit testing.</summary>
-public class NetRef<T> : NetFieldBase<T, NetRef<T>> where T : class { }
+public class NetRef<T> : NetFieldBase<T, NetRef<T>> where T : class;