Paper/patches/api/0373-Add-getDrops-to-BlockState.patch

55 lines
2.3 KiB
Diff
Raw Normal View History

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
2024-04-23 19:02:08 +02:00
index e573e70d9e74e444783a7363e6cdac126124d86d..80e5d39afe8a6cf882b29c0da78450b958812137 100644
--- a/src/main/java/org/bukkit/block/BlockState.java
+++ b/src/main/java/org/bukkit/block/BlockState.java
2024-04-23 19:02:08 +02:00
@@ -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
2023-10-01 02:20:51 +02:00
+ 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
}