Refactor database layer and add module/plugin improvements

Reworked the database layer to support both MySQL and SQLite via new provider classes and migration scripts for each backend. Updated the build workflow to support building and packaging additional modules, including StealthModule and BanSoundModule, and improved artifact handling. Refactored command registration to allow dynamic registration/unregistration and improved API event handling. Updated dependencies, project structure, and configuration checks for better reliability and extensibility. Added new language files, updated versioning, and removed obsolete files.

**⚠️ Warning: SQLite support is currently experimental.
Using this version requires reconfiguration of your database settings!
Plugin now uses UTC time. Please adjust your configurations accordingly!
**

CS2-SimpleAdmin/Managers/PlayerPenaltyManager.cs

@@ -8,7 +8,13 @@ public static class PlayerPenaltyManager
     private static readonly ConcurrentDictionary<int, Dictionary<PenaltyType, List<(DateTime EndDateTime, int Duration, bool Passed)>>> Penalties =
         new();
 
-    // Add a penalty for a player
+    /// <summary>
+    /// Adds a penalty for a specific player slot and penalty type.
+    /// </summary>
+    /// <param name="slot">The player slot where the penalty should be applied.</param>
+    /// <param name="penaltyType">The type of penalty to apply (e.g. gag, mute, silence).</param>
+    /// <param name="endDateTime">The validity expiration date/time of the penalty.</param>
+    /// <param name="durationInMinutes">The duration of the penalty in minutes (0 for permanent).</param>
     public static void AddPenalty(int slot, PenaltyType penaltyType, DateTime endDateTime, int durationInMinutes)
     {
         Penalties.AddOrUpdate(slot,
@@ -33,6 +39,13 @@ public static class PlayerPenaltyManager
             });
     }
 
+    /// <summary>
+    /// Determines whether a player is currently penalized with the given penalty type.
+    /// </summary>
+    /// <param name="slot">The player slot to check.</param>
+    /// <param name="penaltyType">The penalty type to check.</param>
+    /// <param name="endDateTime">The out-parameter returning the end datetime of the penalty if active.</param>
+    /// <returns>True if the player has an active penalty, false otherwise.</returns>
     public static bool IsPenalized(int slot, PenaltyType penaltyType, out DateTime? endDateTime)
     {
         endDateTime = null;
@@ -74,7 +87,12 @@ public static class PlayerPenaltyManager
         return false;
     }
 
-    // Get the end datetime and duration of penalties for a player and penalty type
+    /// <summary>
+    /// Retrieves all penalties for a player of a specific penalty type.
+    /// </summary>
+    /// <param name="slot">The player slot.</param>
+    /// <param name="penaltyType">The penalty type to retrieve.</param>
+    /// <returns>A list of penalties if found, otherwise an empty list.</returns>
     public static List<(DateTime EndDateTime, int Duration, bool Passed)> GetPlayerPenalties(int slot, PenaltyType penaltyType)
     {
         if (Penalties.TryGetValue(slot, out var penaltyDict) &&
@@ -85,6 +103,35 @@ public static class PlayerPenaltyManager
         return [];
     }
     
+    /// <summary>
+    /// Retrieves all penalties for a player across multiple penalty types.
+    /// </summary>
+    /// <param name="slot">The player slot.</param>
+    /// <param name="penaltyType">A list of penalty types to retrieve.</param>
+    /// <returns>A combined list of penalties of all requested types.</returns>
+    public static List<(DateTime EndDateTime, int Duration, bool Passed)> GetPlayerPenalties(int slot, List<PenaltyType> penaltyType)
+    {
+        List<(DateTime EndDateTime, int Duration, bool Passed)> result = [];
+
+        if (Penalties.TryGetValue(slot, out var penaltyDict))
+        {
+            foreach (var type in penaltyType)
+            {
+                if (penaltyDict.TryGetValue(type, out var penaltiesList))
+                {
+                    result.AddRange(penaltiesList);
+                }
+            }
+        }
+
+        return result;
+    }
+    
+    /// <summary>
+    /// Retrieves all penalties for a player across all penalty types.
+    /// </summary>
+    /// <param name="slot">The player slot.</param>
+    /// <returns>A dictionary with penalty types as keys and lists of penalties as values.</returns>
     public static Dictionary<PenaltyType, List<(DateTime EndDateTime, int Duration, bool Passed)>> GetAllPlayerPenalties(int slot)
     {
         // Check if the player has any penalties in the dictionary
@@ -95,12 +142,20 @@ public static class PlayerPenaltyManager
             new Dictionary<PenaltyType, List<(DateTime EndDateTime, int Duration, bool Passed)>>();
     }
 
+    /// <summary>
+    /// Checks if a given slot has any penalties assigned.
+    /// </summary>
+    /// <param name="slot">The player slot.</param>
+    /// <returns>True if the player has any penalties, false otherwise.</returns>
     public static bool IsSlotInPenalties(int slot)
     {
         return Penalties.ContainsKey(slot);
     }
 
-    // Remove all penalties for a player slot
+    /// <summary>
+    /// Removes all penalties assigned to a specific player slot.
+    /// </summary>
+    /// <param name="slot">The player slot.</param>
     public static void RemoveAllPenalties(int slot)
     {
         if (Penalties.ContainsKey(slot))
@@ -109,13 +164,19 @@ public static class PlayerPenaltyManager
         }
     }
 
-    // Remove all penalties
+    /// <summary>
+    /// Removes all penalties for all players.
+    /// </summary>
     public static void RemoveAllPenalties()
     {
         Penalties.Clear();
     }
 
-    // Remove all penalties of a selected type from a specific player
+    /// <summary>
+    /// Removes all penalties of a specific type from a player.
+    /// </summary>
+    /// <param name="slot">The player slot.</param>
+    /// <param name="penaltyType">The penalty type to remove.</param>
     public static void RemovePenaltiesByType(int slot, PenaltyType penaltyType)
     {
         if (Penalties.TryGetValue(slot, out var penaltyDict) &&
@@ -125,6 +186,11 @@ public static class PlayerPenaltyManager
         }
     }
 
+    /// <summary>
+    /// Marks penalties with a specific end datetime as "passed" for a player.
+    /// </summary>
+    /// <param name="slot">The player slot.</param>
+    /// <param name="dateTime">The end datetime of penalties to mark as passed.</param>
     public static void RemovePenaltiesByDateTime(int slot, DateTime dateTime)
     {
         if (!Penalties.TryGetValue(slot, out var penaltyDict)) return;
@@ -146,7 +212,13 @@ public static class PlayerPenaltyManager
         }
     }
 
-    // Remove all expired penalties for all players and penalty types
+    /// <summary>
+    /// Removes or expires penalties automatically across all players based on their duration or "passed" flag.
+    /// </summary>
+    /// <remarks>
+    /// If <c>TimeMode == 0</c>, penalties are considered passed manually and are removed if flagged as such.  
+    /// Otherwise, expired penalties are removed based on the current datetime compared with their end time.
+    /// </remarks>
     public static void RemoveExpiredPenalties()
     {
         if (CS2_SimpleAdmin.Instance.Config.OtherSettings.TimeMode == 0)
@@ -172,13 +244,11 @@ public static class PlayerPenaltyManager
         var now = Time.ActualDateTime();
         foreach (var (playerSlot, penaltyDict) in Penalties.ToList()) // Use ToList to avoid modification while iterating
         {
-            // Remove expired penalties for the player
             foreach (var penaltiesList in penaltyDict.Values)
             {
                 penaltiesList.RemoveAll(p => p.Duration > 0 && now >= p.EndDateTime);
             }
 
-            // Remove player slot if no penalties left
             if (penaltyDict.Count == 0)
             {
                 Penalties.TryRemove(playerSlot, out _);