From b893b69e6c29a4b590d43c8b10d04b5a303f1b9d Mon Sep 17 00:00:00 2001 From: Aikar Date: Wed, 6 Feb 2019 00:19:33 -0500 Subject: [PATCH] BlockDestroyEvent Adds an event for when the server is going to destroy a current block, potentially causing it to drop. This event can be cancelled to avoid the block destruction, such as preventing signs from popping when floating in the air. This can replace many uses of BlockPhysicsEvent diff --git a/src/main/java/com/destroystokyo/paper/event/block/BlockDestroyEvent.java b/src/main/java/com/destroystokyo/paper/event/block/BlockDestroyEvent.java new file mode 100644 index 00000000..a6247718 --- /dev/null +++ b/src/main/java/com/destroystokyo/paper/event/block/BlockDestroyEvent.java @@ -0,0 +1,88 @@ +package com.destroystokyo.paper.event.block; + +import org.bukkit.block.Block; +import org.bukkit.block.data.BlockData; +import org.bukkit.event.Cancellable; +import org.bukkit.event.HandlerList; +import org.bukkit.event.block.BlockEvent; + +/** + * Fired anytime the server intends to 'destroy' a block through some triggering reason. + * This does not fire anytime a block is set to air, but only with more direct triggers such + * as physics updates, pistons, Entities changing blocks, commands set to "Destroy". + * + * This event is associated with the game playing a sound effect at the block in question, when + * something can be described as "intend to destroy what is there", + * + * Events such as leaves decaying, pistons retracting (where the block is moving), does NOT fire this event. + * + */ +public class BlockDestroyEvent extends BlockEvent implements Cancellable { + + private static final HandlerList handlers = new HandlerList(); + + private final BlockData newState; + private final boolean willDrop; + private boolean playEffect; + + private boolean cancelled = false; + + public BlockDestroyEvent(Block block, BlockData newState, boolean willDrop) { + super(block); + this.newState = newState; + this.willDrop = willDrop; + } + + /** + * @return The new state of this block (Air, or a Fluid type) + */ + public BlockData getNewState() { + return newState; + } + + /** + * @return If the server is going to drop the block in question with this destroy event + */ + public boolean willDrop() { + return this.willDrop; + } + + /** + * @return If the server is going to play the sound effect for this destruction + */ + public boolean playEffect() { + return this.playEffect; + } + + /** + * @param playEffect If the server should play the sound effect for this destruction + */ + public void setPlayEffect(boolean playEffect) { + this.playEffect = playEffect; + } + + /** + * @return If the event is cancelled, meaning the block will not be destroyed + */ + @Override + public boolean isCancelled() { + return cancelled; + } + + /** + * If the event is cancelled, the block will remain in its previous state. + * @param cancel true if you wish to cancel this event + */ + @Override + public void setCancelled(boolean cancel) { + cancelled = cancel; + } + + public HandlerList getHandlers() { + return handlers; + } + + public static HandlerList getHandlerList() { + return handlers; + } +} -- 2.20.1