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

EXILED/Exiled.API/Features/Player.cs

@@ -2048,6 +2048,49 @@
         /// <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>
@@ -2112,8 +2155,8 @@
             ItemCategory.Ammo => Inventory.UserInventory.ReserveAmmo.Count(ammo => ammo.Value > 0),
             _ => Inventory.UserInventory.Items.Count(tempItem => tempItem.Value.Category == category),
         };
 
         /// <summary>
         /// Removes an <see cref="Item"/> from the player's inventory.
         /// </summary>
         /// <param name="item">The <see cref="Item"/> to remove.</param>
@@ -2155,6 +2198,22 @@
             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>
+        /// <returns>A value indicating whether the <see cref="Item"/> was removed.</returns>
+        public bool RemoveItem(ItemType item, bool destroy = true)
+        {
+            Item itemtoremove = Items.FirstOrDefault(tempItem => tempItem.Type == item);
+            if (itemtoremove == null)
+                return false;
+
+            RemoveItem(itemtoremove, destroy);
+            return true;
+        }
+
         /// <summary>
         /// Removes an <see cref="Item"/> from the player's inventory.
         /// </summary>