Add clear inventory API to PlayerInventory with a successful count return. Adds BUKKIT-2745

1 files changed, 11 insertions, 0 deletions

diff --git a/src/main/java/org/bukkit/inventory/PlayerInventory.java b/src/main/java/org/bukkit/inventory/PlayerInventory.java
index 57221091..6931ccf9 100644
--- a/src/main/java/org/bukkit/inventory/PlayerInventory.java
+++ b/src/main/java/org/bukkit/inventory/PlayerInventory.java
@@ -102,5 +102,16 @@ public interface PlayerInventory extends Inventory {
      */
     public int getHeldItemSlot();
 
+    /**
+     * Clears all matching items from the inventory. Setting either value to -1 will skip it's check,
+     *  while setting both to -1 will clear all items in your inventory unconditionally.
+     *
+     * @param id the id of the item you want to clear from the inventory
+     * @param data the data of the item you want to clear from the inventory
+     *
+     * @return The number of items cleared
+     */
+    public int clear(int id, int data);
+
     public HumanEntity getHolder();
 }