Class BlockDestroyEvent

All Implemented Interfaces:
Cancellable

@NullMarked public class BlockDestroyEvent extends BlockExpEvent implements Cancellable
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.

  • Constructor Details Link icon

  • Method Details Link icon

    • getEffectBlock Link icon

      public BlockData getEffectBlock()
      Get the effect that will be played when the block is broken.
      Returns:
      block break effect
    • setEffectBlock Link icon

      public void setEffectBlock(BlockData effectBlock)
      Sets the effect that will be played when the block is broken. Note: playEffect() must be true in order for this effect to be played.
      Parameters:
      effectBlock - block effect
    • getNewState Link icon

      public BlockData getNewState()
      Returns:
      The new state of this block (Air, or a Fluid type)
    • willDrop Link icon

      public boolean willDrop()
      Returns:
      If the server is going to drop the block in question with this destroy event
    • setWillDrop Link icon

      public void setWillDrop(boolean willDrop)
      Parameters:
      willDrop - If the server is going to drop the block in question with this destroy event
    • playEffect Link icon

      public boolean playEffect()
      Returns:
      If the server is going to play the sound effect for this destruction
    • setPlayEffect Link icon

      public void setPlayEffect(boolean playEffect)
      Parameters:
      playEffect - If the server should play the sound effect for this destruction
    • isCancelled Link icon

      public boolean isCancelled()
      Description copied from interface: Cancellable
      Gets the cancellation state of this event. A cancelled event will not be executed in the server, but will still pass to other plugins
      Specified by:
      isCancelled in interface Cancellable
      Returns:
      If the event is cancelled, meaning the block will not be destroyed
    • setCancelled Link icon

      public void setCancelled(boolean cancel)
      If the event is cancelled, the block will remain in its previous state.
      Specified by:
      setCancelled in interface Cancellable
      Parameters:
      cancel - true if you wish to cancel this event
    • getHandlers Link icon

      public HandlerList getHandlers()
      Overrides:
      getHandlers in class BlockExpEvent
    • getHandlerList Link icon

      public static HandlerList getHandlerList()