feat(PoolEnergyIconPatches): implement unmapped content warnings for cards, relics, and potions

- Added functionality to log warnings for unmapped cards, relics, and potions that are registered in ModelDb but not included in any respective pool.
- Introduced a locking mechanism to prevent duplicate warnings for the same content, enhancing the clarity of the logging process.
- Refactored pool retrieval logic to improve maintainability and readability.

Author: BAKAOLC

Scaffolding/Content/Patches/PoolEnergyIconPatches.cs

@@ -62,6 +62,8 @@ public static bool Prefix(string prefix, ref string __result)
 
     internal static class ModBigEnergyIconHelper
     {
+        private static readonly Lock UnmappedContentWarningGate = new();
+        private static readonly HashSet<string> UnmappedContentWarningLoggedKeys = new(StringComparer.Ordinal);
         private static Dictionary<string, string>? _cache;
 
         public static bool TryOverridePath(string prefix, ref string result)
@@ -82,18 +84,71 @@ private static Dictionary<string, string> BuildCache()
             foreach (var character in ModContentRegistry.GetModCharacters())
                 AddPoolIfMapped(dict, character.CardPool);
 
-            foreach (var pool in ModelDb.AllCards.Select(c => c.Pool).Distinct())
+            var cardPools = ModelDb.AllCardPools.ToArray();
+            foreach (var pool in cardPools)
                 AddPoolIfMapped(dict, pool);
+            WarnUnmappedCards(cardPools);
 
-            foreach (var pool in ModelDb.AllRelics.Select(r => r.Pool).Distinct())
+            var relicPools = ModelDb.AllRelicPools.ToArray();
+            foreach (var pool in relicPools)
                 AddPoolIfMapped(dict, pool);
+            WarnUnmappedRelics(relicPools);
 
-            foreach (var pool in ModelDb.AllPotions.Select(p => p.Pool).Distinct())
+            var potionPools = ModelDb.AllPotionPools.ToArray();
+            foreach (var pool in potionPools)
                 AddPoolIfMapped(dict, pool);
+            WarnUnmappedPotions(potionPools);
 
             return dict;
         }
 
+        private static void WarnUnmappedCards(CardPoolModel[] pools)
+        {
+            foreach (var card in ModelDb.AllCards)
+            {
+                if (pools.Any(pool => pool.AllCardIds.Contains(card.Id)))
+                    continue;
+
+                WarnUnmappedContentOnce("card", card.Id);
+            }
+        }
+
+        private static void WarnUnmappedRelics(RelicPoolModel[] pools)
+        {
+            foreach (var relic in ModelDb.AllRelics)
+            {
+                if (pools.Any(pool => pool.AllRelicIds.Contains(relic.Id)))
+                    continue;
+
+                WarnUnmappedContentOnce("relic", relic.Id);
+            }
+        }
+
+        private static void WarnUnmappedPotions(PotionPoolModel[] pools)
+        {
+            foreach (var potion in ModelDb.AllPotions)
+            {
+                if (pools.Any(pool => pool.AllPotionIds.Contains(potion.Id)))
+                    continue;
+
+                WarnUnmappedContentOnce("potion", potion.Id);
+            }
+        }
+
+        private static void WarnUnmappedContentOnce(string contentType, ModelId id)
+        {
+            var key = contentType + "\0" + id;
+            lock (UnmappedContentWarningGate)
+            {
+                if (!UnmappedContentWarningLoggedKeys.Add(key))
+                    return;
+            }
+
+            RitsuLibFramework.Logger.Warn(
+                $"[Content] {contentType} '{id}' is registered in ModelDb but is not contained in any {contentType} pool. " +
+                "Skipping it while building energy icon overrides.");
+        }
+
         private static void AddPoolIfMapped(Dictionary<string, string> dict, IPoolModel pool)
         {
             if (pool is not IModBigEnergyIconPool mapped)