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;
/// The path to the game folder.
- [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; }
///
- [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
}
///
- [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
{
/// The XNA Framework, previously used on Windows.
- [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,
/// The MonoGame framework.
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
{
/// Edits matching content assets.
+ [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; }
/// The normalized asset name being read. The format may change between platforms; see to compare with a known path.
- [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; }
/// The content data type.
@@ -32,7 +32,7 @@ namespace StardewModdingAPI
*********/
/// Get whether the asset name being loaded matches a given name after normalization.
/// The expected asset path, relative to the game's content folder and without the .xnb extension or locale suffix (like 'Data\ObjectInformation').
- [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
{
/// 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 instead.
+ [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
/// The command name.
/// The command arguments.
/// Returns whether a matching command was triggered.
- [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);
}
}