Add Debug to properties.yml

LabApi/Features/Console/Logger.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Collections.Generic;
 using System.Reflection;
 
 namespace LabApi.Features.Console;
@@ -22,12 +23,25 @@ public static class Logger
     /// <param name="color">The color of the message.</param>
     public static void Raw(string message, ConsoleColor color) => ServerConsole.AddLog(message, color);
 
+    /// <summary>
+    /// List of assemblies to display Debug level logs for.
+    /// </summary>
+    public static HashSet<Assembly> DebugEnabled { get; } = new();
+
+    /// <summary>
+    /// Logs a debug message to the server console.
+    /// </summary>
+    /// <param name="message">The message to log.</param>
+    public static void Debug(object message) => Debug(
+        message,
+        Loader.PluginLoader.Config?.DebugOverride == true || DebugEnabled.Contains(Assembly.GetCallingAssembly()));
+
     /// <summary>
     /// Logs a debug message to the server console.
     /// </summary>
     /// <param name="message">The message to log.</param>
     /// <param name="canBePrinted">Whether the message can be printed.</param>
-    public static void Debug(object message, bool canBePrinted = true)
+    public static void Debug(object message, bool canBePrinted)
     {
         if (!canBePrinted)
         {

LabApi/Loader/Features/Configuration/LabApiConfig.cs

@@ -1,4 +1,5 @@
 using LabApi.Loader.Features.Paths;
+using LabApi.Loader.Features.Plugins.Configuration;
 using System.Collections.Generic;
 using System.ComponentModel;
 
@@ -24,7 +25,14 @@ public class LabApiConfig
     /// <summary>
     /// Whether to allow loading plugins even if they were built for a different major version of LabAPI.
     /// </summary>
-    /// <seealso cref="LabApi.Loader.Features.Plugins.Configuration.Properties.UnsupportedLoading"/>
+    /// <seealso cref="Properties.UnsupportedLoading"/>
     [Description("Whether to allow loading plugins even if they were built for a different major version of LabAPI.")]
     public bool LoadUnsupportedPlugins { get; set; }
+
+    /// <summary>
+    /// Whether debug logs should appear regardless of pre-plugin properties.
+    /// </summary>
+    /// <seealso cref="Properties.Debug"/>
+    [Description("Whether debug logs should be printed regardless of per-plugin properties. Only recommended during Plugin development.")]
+    public bool DebugOverride { get; set; } = false;
 }

LabApi/Loader/Features/Plugins/Configuration/Properties.cs

@@ -20,6 +20,12 @@ public class Properties
     [Description("Whether or not the plugin is enabled.")]
     public bool IsEnabled { get; set; } = true;
 
+    /// <summary>
+    /// Whether Debug logs should be printed for this plugin.
+    /// </summary>
+    [Description("Whether or not [DEBUG] log messages should appear in the console. Default is false.")]
+    public bool Debug { get; set; } = false;
+
     /// <summary>
     /// Whether to allow loading the plugin even if it was built for a different major version of LabAPI.
     /// </summary>

LabApi/Loader/PluginLoader.cs

@@ -233,6 +233,8 @@ public static void LoadPlugins(IEnumerable<FileInfo> files)
     /// <param name="plugins">The sorted collection of <see cref="Plugin"/>s.</param>
     public static void EnablePlugins(IEnumerable<Plugin> plugins)
     {
+        Logger.DebugEnabled.Clear();
+
         foreach (Plugin plugin in plugins)
         {
             // We try to load the configuration of the plugin
@@ -253,6 +255,20 @@ public static void EnablePlugins(IEnumerable<Plugin> plugins)
                 continue;
             }
 
+            // Check if the plugin associated with this assembly wants Debug logs enabled.
+            if (plugin.Properties?.Debug == true)
+            {
+                // This body will not be run on most live servers.
+                if (Plugins.TryGetValue(plugin, out Assembly asm))
+                {
+                    if (Logger.DebugEnabled.Add(asm))
+                    {
+                        // Only want to print when the first plugin in an assembly enables Debug
+                        Logger.Info($"Debug logging enabled for {asm.FullName}");
+                    }
+                }
+            }
+
             // We finally enable the plugin
             EnablePlugin(plugin);
         }