feat(Player): Player::RemoveItem(ItemType, bool) method

EXILED/Exiled.API/Features/Player.cs

@@ -2119,6 +2119,50 @@
         /// <returns>dropped <see cref="Pickup"/>.</returns>
         public Pickup DropItem(Item item) => item is not null ? Pickup.Get(Inventory.ServerDropItem(item.Serial)) : null;
 
+        /// <summary>
+        /// Drops an <see cref="Item"/> from the player's inventory by its <see cref="ItemType"/>.
+        /// </summary>
+        /// <param name="item">The specified <see cref="ItemType"/> to be dropped.</param>
+        /// <param name="isThrown">Whether the item should be thrown.</param>
+        /// <param name="amount">The number of matching items to remove.</param>
+        /// <returns>A value indicating whether the <see cref="Item"/> was dropped.</returns>
+        public bool DropItem(ItemType item, bool isThrown = false, int amount = 1)
+        {
+            if (amount <= 0)
+                return false;
+
+            List<Item> itemsToDrop = Items.Where(i => i?.Type == item).Take(amount).ToList();
+
+            if (itemsToDrop.Count == 0)
+                return false;
+
+            foreach (Item i in itemsToDrop)
+                DropItem(i, isThrown);
+
+            return itemsToDrop.Count > 0;
+        }
+
+        /// <summary>
+        /// Drops an item from the player's inventory.
+        /// </summary>
+        /// <param name="item">The specified <see cref="ItemType"/> to be dropped.</param>
+        /// <param name="amount">The number of matching items to remove.</param>
+        /// <returns>A list of dropped <see cref="Pickup"/>s.</returns>
+        public List<Pickup> DropItem(ItemType item, int amount = 1)
+        {
+            List<Pickup> pickups = new();
+
+            if (amount <= 0)
+                return pickups;
+
+            List<Item> itemsToDrop = Items.Where(i => i?.Type == item).Take(amount).ToList();
+
+            foreach (Item i in itemsToDrop)
+                pickups.Add(DropItem(i));
+
+            return pickups;
+        }
+
         /// <summary>
         /// Drops the held item. Will not do anything if the player is not holding an item.
         /// </summary>
@@ -2226,6 +2270,28 @@
             return true;
         }
 
+        /// <summary>
+        /// Removes an <see cref="Item"/> from the player's inventory by its <see cref="ItemType"/>.
+        /// </summary>
+        /// <param name="item">The specified <see cref="ItemType"/> to be removed.</param>
+        /// <param name="destroy">Whether to destroy the item.</param>
+        /// <param name="amount">The number of matching items to remove.</param>
+        /// <returns>A value indicating whether the <see cref="Item"/> was removed.</returns>
+        public bool RemoveItem(ItemType item, bool destroy = true, int amount = 1)
+        {
+            if (amount <= 0)
+                return false;
+
+            List<Item> itemsToRemove = Items.Where(i => i?.Type == item).Take(amount).ToList();
+
+            if (itemsToRemove.Count == 0)
+                return false;
+
+            foreach (Item i in itemsToRemove)
+                RemoveItem(i, destroy);
+
+            return true;
+        }
         /// <summary>
         /// Removes an <see cref="Item"/> from the player's inventory.
         /// </summary>
@@ -2276,8 +2342,8 @@
 
         /// <summary>
         /// Disconnects the player.
         /// </summary>
         /// <param name="reason">The disconnection reason.</param>
         public void Disconnect(string reason = null) =>
             ServerConsole.Disconnect(GameObject, string.IsNullOrEmpty(reason) ? string.Empty : reason);