summaryrefslogtreecommitdiffstats
path: root/src
diff options
context:
space:
mode:
Diffstat (limited to 'src')
-rw-r--r--src/main/java/org/bukkit/inventory/Inventory.java16
1 files changed, 15 insertions, 1 deletions
diff --git a/src/main/java/org/bukkit/inventory/Inventory.java b/src/main/java/org/bukkit/inventory/Inventory.java
index b05acf96..e4bc9afd 100644
--- a/src/main/java/org/bukkit/inventory/Inventory.java
+++ b/src/main/java/org/bukkit/inventory/Inventory.java
@@ -38,7 +38,10 @@ 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
@@ -46,6 +49,17 @@ public interface Inventory {
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
*
* @return All the ItemStacks from all slots