From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001 From: MelnCat <melncatuwu@gmail.com> Date: Fri, 12 Aug 2022 23:24:53 -0700 Subject: [PATCH] Add getDrops to BlockState Originally added isPreferredTool to BlockData but upstream added that. diff --git a/src/main/java/org/bukkit/block/BlockState.java b/src/main/java/org/bukkit/block/BlockState.java index e573e70d9e74e444783a7363e6cdac126124d86d..80e5d39afe8a6cf882b29c0da78450b958812137 100644 --- a/src/main/java/org/bukkit/block/BlockState.java +++ b/src/main/java/org/bukkit/block/BlockState.java @@ -253,5 +253,41 @@ public interface BlockState extends Metadatable { * @return true if collidable */ boolean isCollidable(); + + /** + * Returns an immutable list of items which would drop by destroying this block state. + * + * @return an immutable list of dropped items for the block state + * @throws IllegalStateException if this block state is not placed + */ + @NotNull + default java.util.@org.jetbrains.annotations.Unmodifiable Collection<org.bukkit.inventory.ItemStack> getDrops() { + return this.getDrops(null); + } + + /** + * Returns an immutable list of items which would drop by destroying this block state + * with a specific tool + * + * @param tool The tool or item in hand used for digging + * @return an immutable list of dropped items for the block state + * @throws IllegalStateException if this block state is not placed + */ + @NotNull + default java.util.@org.jetbrains.annotations.Unmodifiable Collection<org.bukkit.inventory.ItemStack> getDrops(@Nullable org.bukkit.inventory.ItemStack tool) { + return this.getDrops(tool, null); + } + + /** + * Returns an immutable list of items which would drop by the entity destroying this + * block state with a specific tool + * + * @param tool The tool or item in hand used for digging + * @param entity the entity destroying the block + * @return an immutable list of dropped items for the block state + * @throws IllegalStateException if this block state is not placed + */ + @NotNull + java.util.@org.jetbrains.annotations.Unmodifiable Collection<org.bukkit.inventory.ItemStack> getDrops(@Nullable org.bukkit.inventory.ItemStack tool, @Nullable org.bukkit.entity.Entity entity); // Paper end }