aboutsummaryrefslogtreecommitdiffhomepage
path: root/patches/api/0371-Add-getDrops-to-BlockState.patch
blob: f9e81522293ec3866f22ff37682c86bc76e3aaea (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
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
 }