Package io.papermc.paper.event.block

Class PlayerShearBlockEvent

java.lang.Object

org.bukkit.event.Event

org.bukkit.event.player.PlayerEvent

io.papermc.paper.event.block.PlayerShearBlockEvent

All Implemented Interfaces:

Cancellable

public class PlayerShearBlockEvent
extends PlayerEvent
implements Cancellable

Called when a player uses sheers on a block.

This event is not called when breaking blocks with shears but instead only when a player uses the sheer item on a block to garner drops from said block and/or change its state.

Examples include shearing a pumpkin to turn it into a carved pumpkin or shearing a beehive to get honeycomb.

Nested Class Summary

Nested classes/interfaces inherited from class org.bukkit.event.Event

Event.Result

Field Summary

Fields inherited from class org.bukkit.event.player.PlayerEvent

player

Constructor Summary

Constructors

Constructor	Description
PlayerShearBlockEvent(Player who, Block block, ItemStack item, EquipmentSlot hand, List<ItemStack> drops)

Method Summary

Modifier and Type	Method	Description
Block	getBlock()	Gets the block being sheared in this event.
List<ItemStack>	getDrops()	Gets the resulting drops of this event.
EquipmentSlot	getHand()	Gets the hand used to shear the block.
static HandlerList	getHandlerList()
HandlerList	getHandlers()
ItemStack	getItem()	Gets the item used to shear the block.
boolean	isCancelled()	Gets whether the shearing of the block should be cancelled or not.
void	setCancelled(boolean cancel)	Sets whether the shearing of the block should be cancelled or not.

Methods inherited from class org.bukkit.event.Event

callEvent, getEventName, isAsynchronous

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from class org.bukkit.event.player.PlayerEvent

getPlayer

Constructor Detail

PlayerShearBlockEvent

public PlayerShearBlockEvent(@NotNull
                             Player who,
                             @NotNull
                             Block block,
                             @NotNull
                             ItemStack item,
                             @NotNull
                             EquipmentSlot hand,
                             @NotNull
                             List<ItemStack> drops)

Method Detail

getBlock

@NotNull
public Block getBlock()

Gets the block being sheared in this event.

Returns:

The Block which block is being sheared in this event.

getItem

@NotNull
public ItemStack getItem()

Gets the item used to shear the block.

Returns:

The ItemStack of the shears.

getHand

@NotNull
public EquipmentSlot getHand()

Gets the hand used to shear the block.

Returns:

Either EquipmentSlot.HAND OR EquipmentSlot.OFF_HAND.

getDrops

@NotNull
public List<ItemStack> getDrops()

Gets the resulting drops of this event.

Returns:

A list of items that will be dropped as result of this event.

isCancelled

public boolean isCancelled()

Gets whether the shearing of the block should be cancelled or not.

Specified by:

isCancelled in interface Cancellable

Returns:

Whether the shearing of the block should be cancelled or not.

setCancelled

public void setCancelled(boolean cancel)

Sets whether the shearing of the block should be cancelled or not.

Specified by:

setCancelled in interface Cancellable

Parameters:

cancel - whether the shearing of the block should be cancelled or not.

getHandlers

@NotNull
public HandlerList getHandlers()

Specified by:

getHandlers in class Event

getHandlerList

@NotNull
public static HandlerList getHandlerList()