SPIGOT-1936: LootTable API

By: Senmori <thesenmori@gmail.com>

paper-api/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);
+}