Package org.bukkit.event.player

Class PlayerInteractEvent

  • All Implemented Interfaces:
    Cancellable
    public class PlayerInteractEvent
extends PlayerEvent
implements Cancellable
    Represents an event that is called when a player interacts with an object or air, potentially fired once for each hand. The hand can be determined using getHand().

    This event will fire as cancelled if the vanilla behavior is to do nothing (e.g interacting with air)

    • Method Detail

      • getAction

        public Action getAction()
        Returns the action type
        Returns:
        Action returns the type of interaction

      • isCancelled

        public boolean isCancelled()
        Gets the cancellation state of this event. Set to true if you want to prevent buckets from placing water and so forth
        Specified by:
        isCancelled in interface Cancellable
        Returns:
        boolean cancellation state

      • setCancelled

        public void setCancelled​(boolean cancel)
        Sets the cancellation state of this event. A canceled event will not be executed in the server, but will still pass to other plugins

        Canceling this event will prevent use of food (player won't lose the food item), prevent bows/snowballs/eggs from firing, etc. (player won't lose the ammo)

        Specified by:
        setCancelled in interface Cancellable
        Parameters:
        cancel - true if you wish to cancel this event

      • getItem

        public ItemStack getItem()
        Returns the item in hand represented by this event
        Returns:
        ItemStack the item used

      • getMaterial

        public Material getMaterial()
        Convenience method. Returns the material of the item represented by this event
        Returns:
        Material the material of the item used

      • hasBlock

        public boolean hasBlock()
        Check if this event involved a block
        Returns:
        boolean true if it did

      • hasItem

        public boolean hasItem()
        Check if this event involved an item
        Returns:
        boolean true if it did

      • isBlockInHand

        public boolean isBlockInHand()
        Convenience method to inform the user whether this was a block placement event.
        Returns:
        boolean true if the item in hand was a block

      • getClickedBlock

        public Block getClickedBlock()
        Returns the clicked block
        Returns:
        Block returns the block clicked with this item.

      • getBlockFace

        public BlockFace getBlockFace()
        Returns the face of the block that was clicked
        Returns:
        BlockFace returns the face of the block that was clicked

      • useInteractedBlock

        public Event.Result useInteractedBlock()
        This controls the action to take with the block (if any) that was clicked on. This event gets processed for all blocks, but most don't have a default action
        Returns:
        the action to take with the interacted block

      • setUseInteractedBlock

        public void setUseInteractedBlock​(Event.Result useInteractedBlock)
        Parameters:
        useInteractedBlock - the action to take with the interacted block

      • useItemInHand

        public Event.Result useItemInHand()
        This controls the action to take with the item the player is holding. This includes both blocks and items (such as flint and steel or records). When this is set to default, it will be allowed if no action is taken on the interacted block.
        Returns:
        the action to take with the item in hand

      • setUseItemInHand

        public void setUseItemInHand​(Event.Result useItemInHand)
        Parameters:
        useItemInHand - the action to take with the item in hand

      • getHand

        public EquipmentSlot getHand()
        The hand used to perform this interaction. May be null in the case of Action.PHYSICAL.
        Returns:
        the hand used to interact. May be null.

      • getHandlerList

        public static HandlerList getHandlerList()