Closes #2873

ArchiSteamFarm/Plugins/Interfaces/IBotCustomMachineInfoProvider.cs

@@ -0,0 +1,39 @@
+//     _                _      _  ____   _                           _____
+//    / \    _ __  ___ | |__  (_)/ ___| | |_  ___   __ _  _ __ ___  |  ___|__ _  _ __  _ __ ___
+//   / _ \  | '__|/ __|| '_ \ | |\___ \ | __|/ _ \ / _` || '_ ` _ \ | |_  / _` || '__|| '_ ` _ \
+//  / ___ \ | |  | (__ | | | || | ___) || |_|  __/| (_| || | | | | ||  _|| (_| || |   | | | | | |
+// /_/   \_\|_|   \___||_| |_||_||____/  \__|\___| \__,_||_| |_| |_||_|   \__,_||_|   |_| |_| |_|
+// |
+// Copyright 2015-2023 Łukasz "JustArchi" Domeradzki
+// Contact: JustArchi@JustArchi.net
+// |
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+// |
+// http://www.apache.org/licenses/LICENSE-2.0
+// |
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+using System.Threading.Tasks;
+using ArchiSteamFarm.Steam;
+using JetBrains.Annotations;
+using SteamKit2;
+
+namespace ArchiSteamFarm.Plugins.Interfaces;
+
+[PublicAPI]
+public interface IBotCustomMachineInfoProvider : IPlugin {
+	/// <summary>
+	///     ASF will use this property as the <see cref="IMachineInfoProvider" /> for the specified bot.
+	///     Unless you know what you're doing, you should not implement this interface yourself and let ASF decide.
+	/// </summary>
+	/// <remarks>This method will be called with very limited amount of bot-related data, as it's used during bot initialization. We recommend to stick with <see cref="Bot.BotName" />, <see cref="Bot.BotConfig" /> and <see cref="Bot.BotDatabase" /> exclusively.</remarks>
+	/// <param name="bot">Bot object related to this callback.</param>
+	/// <returns><see cref="IMachineInfoProvider" /> that will be used for the particular bot. You can return null if you want to use default implementation.</returns>
+	Task<IMachineInfoProvider?> GetMachineInfoProvider(Bot bot);
+}

ArchiSteamFarm/Plugins/Interfaces/ICustomMachineInfoProvider.cs

@@ -19,11 +19,13 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 
+using System;
 using JetBrains.Annotations;
 using SteamKit2;
 
 namespace ArchiSteamFarm.Plugins.Interfaces;
 
+[Obsolete($"Use {nameof(IBotCustomMachineInfoProvider)} instead, this interface will be removed in the future version")]
 [PublicAPI]
 public interface ICustomMachineInfoProvider : IPlugin {
 	/// <summary>

ArchiSteamFarm/Plugins/PluginsCore.cs

@@ -137,22 +137,24 @@ public static class PluginsCore {
 		return lastChangeNumber;
 	}
 
-	internal static async Task<IMachineInfoProvider?> GetCustomMachineInfoProvider() {
+	internal static async Task<IMachineInfoProvider?> GetCustomMachineInfoProvider(Bot bot) {
 		if (ActivePlugins == null) {
 			return null;
 		}
 
-		IList<IMachineInfoProvider> results;
+		IList<IMachineInfoProvider?> results;
 
 		try {
-			results = await Utilities.InParallel(ActivePlugins.OfType<ICustomMachineInfoProvider>().Select(static plugin => Task.Run(() => plugin.MachineInfoProvider))).ConfigureAwait(false);
+			results = await Utilities.InParallel(ActivePlugins.OfType<IBotCustomMachineInfoProvider>().Select(plugin => plugin.GetMachineInfoProvider(bot))).ConfigureAwait(false);
 		} catch (Exception e) {
 			ASF.ArchiLogger.LogGenericException(e);
 
 			return null;
 		}
 
-		return results.FirstOrDefault();
+#pragma warning disable CS0612 // TODO: Fair warning, remove ?? fallback in the next release cycle
+		return results.FirstOrDefault(static result => result != null) ?? await GetCustomMachineInfoProviderFallback().ConfigureAwait(false);
+#pragma warning restore CS0612 // TODO: Fair warning, remove ?? fallback in the next release cycle
 	}
 
 	[UnconditionalSuppressMessage("AssemblyLoadTrimming", "IL2026:RequiresUnreferencedCode", Justification = "We don't care about trimmed assemblies, as we need it to work only with the known (used) ones")]
@@ -651,6 +653,25 @@ public static class PluginsCore {
 		}
 	}
 
+	[Obsolete]
+	private static async Task<IMachineInfoProvider?> GetCustomMachineInfoProviderFallback() {
+		if (ActivePlugins == null) {
+			return null;
+		}
+
+		IList<IMachineInfoProvider> results;
+
+		try {
+			results = await Utilities.InParallel(ActivePlugins.OfType<ICustomMachineInfoProvider>().Select(static plugin => Task.Run(() => plugin.MachineInfoProvider))).ConfigureAwait(false);
+		} catch (Exception e) {
+			ASF.ArchiLogger.LogGenericException(e);
+
+			return null;
+		}
+
+		return results.FirstOrDefault();
+	}
+
 	[UnconditionalSuppressMessage("AssemblyLoadTrimming", "IL2026:RequiresUnreferencedCode", Justification = "We don't care about trimmed assemblies, as we need it to work only with the known (used) ones")]
 	private static HashSet<Assembly>? LoadAssembliesFrom(string path) {
 		if (string.IsNullOrEmpty(path)) {