mirror of https://github.com/PaperMC/Paper.git
69 lines
2.7 KiB
Diff
69 lines
2.7 KiB
Diff
From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
|
|
From: Jake Potrebic <jake.m.potrebic@gmail.com>
|
|
Date: Thu, 2 Jan 2020 12:25:16 -0600
|
|
Subject: [PATCH] Improve Block#breakNaturally API
|
|
|
|
Adds bool param to trigger world particle effects
|
|
|
|
Adds bool param to trigger exp drops for blocks
|
|
|
|
Co-authored-by: William Blake Galbreath <Blake.Galbreath@GMail.com>
|
|
|
|
diff --git a/src/main/java/org/bukkit/block/Block.java b/src/main/java/org/bukkit/block/Block.java
|
|
index f468e9751f75fd355512e033c180de967de5b2d8..bf29d9b733afc7c62725d259f4920c4f211cc6d0 100644
|
|
--- a/src/main/java/org/bukkit/block/Block.java
|
|
+++ b/src/main/java/org/bukkit/block/Block.java
|
|
@@ -481,6 +481,52 @@ public interface Block extends Metadatable, Translatable {
|
|
*/
|
|
boolean breakNaturally(@Nullable ItemStack tool);
|
|
|
|
+ // Paper start
|
|
+ /**
|
|
+ * Breaks the block and spawns item drops as if a player had broken it
|
|
+ *
|
|
+ * @param triggerEffect Play the block break particle effect and sound
|
|
+ * @return true if the block was destroyed
|
|
+ * @see #breakNaturally(boolean, boolean) to trigger exp drops
|
|
+ */
|
|
+ default boolean breakNaturally(boolean triggerEffect) {
|
|
+ return this.breakNaturally(triggerEffect, false);
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Breaks the block and spawns item drops as if a player had broken it
|
|
+ *
|
|
+ * @param triggerEffect Play the block break particle effect and sound
|
|
+ * @param dropExperience drop exp if the block normally does so
|
|
+ * @return true if the block was destroyed
|
|
+ */
|
|
+ boolean breakNaturally(boolean triggerEffect, boolean dropExperience);
|
|
+
|
|
+ /**
|
|
+ * Breaks the block and spawns item drops as if a player had broken it
|
|
+ * with a specific tool
|
|
+ *
|
|
+ * @param tool The tool or item in hand used for digging
|
|
+ * @param triggerEffect Play the block break particle effect and sound
|
|
+ * @return true if the block was destroyed
|
|
+ * @see #breakNaturally(ItemStack, boolean, boolean) to trigger exp drops
|
|
+ */
|
|
+ default boolean breakNaturally(@NotNull ItemStack tool, boolean triggerEffect) {
|
|
+ return this.breakNaturally(tool, triggerEffect, false);
|
|
+ }
|
|
+
|
|
+ /**
|
|
+ * Breaks the block and spawns item drops as if a player had broken it
|
|
+ * with a specific tool
|
|
+ *
|
|
+ * @param tool The tool or item in hand used for digging
|
|
+ * @param triggerEffect Play the block break particle effect and sound
|
|
+ * @param dropExperience drop exp if the block normally does so
|
|
+ * @return true if the block was destroyed
|
|
+ */
|
|
+ boolean breakNaturally(@NotNull ItemStack tool, boolean triggerEffect, boolean dropExperience);
|
|
+ // Paper end
|
|
+
|
|
/**
|
|
* Simulate bone meal application to this block (if possible).
|
|
*
|