diff --git a/paper-api/src/main/java/org/bukkit/inventory/Inventory.java b/paper-api/src/main/java/org/bukkit/inventory/Inventory.java
index b05acf9642..e4bc9afd59 100644
--- a/paper-api/src/main/java/org/bukkit/inventory/Inventory.java
+++ b/paper-api/src/main/java/org/bukkit/inventory/Inventory.java
@@ -38,13 +38,27 @@ public interface Inventory {
      public void setItem(int index, ItemStack item);
 
     /**
-     * Stores the given ItemStacks in the inventory 
+     * Stores the given ItemStacks in the inventory.
+     * 
+     * This will try to fill existing stacks and empty slots as good as it can.
+     * It will return a HashMap of what it couldn't fit.
      * 
      * @param items The ItemStacks to add
      * @return 
      */
      public HashMap<Integer, ItemStack> addItem(ItemStack... items);
 
+    /**
+     * Removes the given ItemStacks from the inventory.
+     * 
+     * It will try to remove 'as much as possible' from the types and amounts you
+     * give as arguments. It will return a HashMap of what it couldn't remove.
+     * 
+     * @param items The ItemStacks to remove
+     * @return 
+     */
+     public HashMap<Integer, ItemStack> removeItem(ItemStack... items);
+
     /**
      * Get all ItemStacks from the inventory
      *