summaryrefslogtreecommitdiffstats
path: root/src/main/java/org/bukkit/loot/LootTable.java
diff options
context:
space:
mode:
Diffstat (limited to 'src/main/java/org/bukkit/loot/LootTable.java')
-rw-r--r--src/main/java/org/bukkit/loot/LootTable.java37
1 files changed, 37 insertions, 0 deletions
diff --git a/src/main/java/org/bukkit/loot/LootTable.java b/src/main/java/org/bukkit/loot/LootTable.java
new file mode 100644
index 00000000..30b16200
--- /dev/null
+++ b/src/main/java/org/bukkit/loot/LootTable.java
@@ -0,0 +1,37 @@
+package org.bukkit.loot;
+
+import org.bukkit.Keyed;
+import org.bukkit.inventory.Inventory;
+import org.bukkit.inventory.ItemStack;
+
+import java.util.Collection;
+import java.util.Random;
+
+/**
+ * LootTables are technical files that represent what items should be in
+ * naturally generated containers, what items should be dropped when killing a
+ * mob, or what items can be fished.
+ *
+ * See the <a href="https://minecraft.gamepedia.com/Loot_table">
+ * Minecraft Wiki</a> for more information.
+ */
+public interface LootTable extends Keyed {
+
+ /**
+ * Returns a mutable list of loot generated by this LootTable.
+ *
+ * @param random the random instance to use to generate loot
+ * @param context context within to populate loot
+ * @return a list of ItemStacks
+ */
+ Collection<ItemStack> populateLoot(Random random, LootContext context);
+
+ /**
+ * Attempt to fill an inventory with this LootTable's loot.
+ *
+ * @param inventory the inventory to fill
+ * @param random the random instance to use to generate loot
+ * @param context context within to populate loot
+ */
+ void fillInventory(Inventory inventory, Random random, LootContext context);
+}