tweak player_add error messages for clarity

Author: Pathoschild

docs/release-notes.md

@@ -5,6 +5,7 @@
 * For players:
   * Update compatibility rewrites for Stardew Valley 1.6.3.
   * Updated mod compatibility list.
+  * Tweaked `player_add` console command's error messages for clarity.
 
 ## 4.0.2
 Released 24 March 2024 for Stardew Valley 1.6.0 or later.

src/SMAPI.Mods.ConsoleCommands/Framework/Commands/Player/AddCommand.cs

@@ -144,7 +144,7 @@ private bool TryReadArguments(ArgumentParser args, out string? id, out string? n
             SearchableItem[] matches = this.Items.GetAll().Where(p => p.NameContains(name)).ToArray();
             if (!matches.Any())
             {
-                monitor.Log($"There's no item with name '{name}'. You can use the 'list_items [name]' command to search for items.", LogLevel.Error);
+                monitor.Log($"There's no item whose name contains '{name}'. You can use 'list_items' command to list all items, or search like 'list_items {name}'.", LogLevel.Error);
                 return null;
             }
 
@@ -159,7 +159,7 @@ private bool TryReadArguments(ArgumentParser args, out string? id, out string? n
                 header: new[] { "type", "name", "command" },
                 getRow: item => new[] { item.Type.ToString(), item.DisplayName, $"player_add {item.QualifiedItemId}" }
             );
-            monitor.Log($"There's no item with name '{name}'. Do you mean one of these?\n\n{options}", LogLevel.Info);
+            monitor.Log($"Multiple items have a name containing '{name}'. Do you mean one of these?\n\n{options}", LogLevel.Info);
             return null;
         }