aboutsummaryrefslogtreecommitdiffhomepage
path: root/patches/api/0391-Block-Ticking-API.patch
diff options
context:
space:
mode:
Diffstat (limited to 'patches/api/0391-Block-Ticking-API.patch')
-rw-r--r--patches/api/0391-Block-Ticking-API.patch51
1 files changed, 51 insertions, 0 deletions
diff --git a/patches/api/0391-Block-Ticking-API.patch b/patches/api/0391-Block-Ticking-API.patch
new file mode 100644
index 0000000000..7c077405ca
--- /dev/null
+++ b/patches/api/0391-Block-Ticking-API.patch
@@ -0,0 +1,51 @@
+From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
+From: Owen1212055 <[email protected]>
+Date: Sun, 26 Dec 2021 13:23:52 -0500
+Subject: [PATCH] Block Ticking API
+
+
+diff --git a/src/main/java/org/bukkit/block/Block.java b/src/main/java/org/bukkit/block/Block.java
+index e405c279f6135c94c775a856ab88fd3cace6bd5c..9930ebe7a23d306c602840fd43652fbdaba481b3 100644
+--- a/src/main/java/org/bukkit/block/Block.java
++++ b/src/main/java/org/bukkit/block/Block.java
+@@ -562,6 +562,21 @@ public interface Block extends Metadatable, net.kyori.adventure.translation.Tran
+ * @return true if the block was destroyed
+ */
+ boolean breakNaturally(@NotNull ItemStack tool, boolean triggerEffect);
++
++ /**
++ * Causes the block to be ticked, this is different from {@link Block#randomTick()},
++ * in that it is usually scheduled to occur, for example
++ * redstone components being activated, sand falling, etc.
++ */
++ void tick();
++
++ /**
++ * Causes the block to be ticked randomly.
++ * This has a chance to execute naturally if {@link BlockData#isRandomlyTicked()} is true.
++ * <p>
++ * For certain blocks, this behavior may be the same as {@link Block#tick()}.
++ */
++ void randomTick();
+ // Paper end
+
+ /**
+diff --git a/src/main/java/org/bukkit/block/data/BlockData.java b/src/main/java/org/bukkit/block/data/BlockData.java
+index 62273e32e87b0dbc568747a67156366d4d4972bd..bd987bd0a29618dfe07de50b194fd6fa694628ec 100644
+--- a/src/main/java/org/bukkit/block/data/BlockData.java
++++ b/src/main/java/org/bukkit/block/data/BlockData.java
+@@ -151,4 +151,14 @@ public interface BlockData extends Cloneable {
+ * @return true if the face is sturdy and can support a block, false otherwise
+ */
+ boolean isFaceSturdy(@NotNull BlockFace face, @NotNull BlockSupport support);
++
++ // Paper start - Tick API
++ /**
++ * Gets if this block is ticked randomly in the world.
++ * The blocks current state may change this value.
++ *
++ * @return is ticked randomly
++ */
++ boolean isRandomlyTicked();
++ // Paper end
+ }