Player.ResetInventory(List<string>) extension

Exiled.CustomItems/API/Extensions.cs

@@ -41,6 +41,35 @@ public static class Extensions
             SpawnLocation.InsideHid,
         };
 
+        /// <summary>
+        /// Resets the player's inventory to the provided list of items and/or customitems names, clearing any items it already possess.
+        /// </summary>
+        /// <param name="player">The player to which items will be given.</param>
+        /// <param name="newItems">The new items that have to be added to the inventory.</param>
+        /// <param name="displayMessage">Indicates a value whether <see cref="CustomItem.ShowPickedUpMessage"/> will be called when the player receives the <see cref="CustomItem"/> or not.</param>
+        public static void ResetInventory(this Player player, List<string> newItems, bool displayMessage = false)
+        {
+            foreach (Inventory.SyncItemInfo item in player.Inventory.items)
+            {
+                if (CustomItem.TryGet(item, out CustomItem customItem))
+                    customItem.InsideInventories.Remove(item.uniq);
+            }
+
+            player.ClearInventory();
+
+            foreach (string item in newItems)
+            {
+                if (Enum.TryParse(item, true, out ItemType parsedItem))
+                {
+                    player.AddItem(parsedItem);
+                }
+                else if (!CustomItem.TryGive(player, item, displayMessage))
+                {
+                    Log.Debug($"\"{item}\" is not a valid item name, nor a custom item name.", CustomItems.Instance.Config.Debug);
+                }
+            }
+        }
+
         /// <summary>
         /// Tries to get the <see cref="Transform"/> of the door used for a specific <see cref="SpawnLocation"/>.
         /// </summary>