From e9ec8e1b5827c56c4bc70b720e113306ad58ba8d Mon Sep 17 00:00:00 2001 From: Bukkit/Spigot Date: Mon, 28 Mar 2016 16:31:57 +1100 Subject: [PATCH] Add some Inventory addItem / removeItem notes By: md_5 --- .../src/main/java/org/bukkit/inventory/Inventory.java | 8 ++++++++ 1 file changed, 8 insertions(+) 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 5832e24518..3275e1720a 100644 --- a/paper-api/src/main/java/org/bukkit/inventory/Inventory.java +++ b/paper-api/src/main/java/org/bukkit/inventory/Inventory.java @@ -85,6 +85,10 @@ public interface Inventory extends Iterable { * Material.getMaxStackSize(). When there are no partial stacks left * stacks will be split on Inventory.getMaxStackSize() allowing you to * exceed the maximum stack size for that material. + *

+ * It is known that in some implementations this method will also set + * the inputted argument amount to the number of that item not placed in + * slots. * * @param items The ItemStacks to add * @return A HashMap containing items that didn't fit. @@ -102,6 +106,10 @@ public interface Inventory extends Iterable { * the index of the parameter, and the value is the ItemStack at that * index of the varargs parameter. If all the given ItemStacks are * removed, it will return an empty HashMap. + *

+ * It is known that in some implementations this method will also set the + * inputted argument amount to the number of that item not removed from + * slots. * * @param items The ItemStacks to remove * @return A HashMap containing items that couldn't be removed.