Class EntityShootBowEvent

  • All Implemented Interfaces:
    Cancellable

    public class EntityShootBowEvent
    extends EntityEvent
    implements Cancellable
    Called when a LivingEntity shoots a bow firing an arrow
    • Method Detail

      • getBow

        @Nullable
        public ItemStack getBow()
        Gets the bow ItemStack used to fire the arrow.
        Returns:
        the bow involved in this event
      • getConsumable

        @Nullable
        public ItemStack getConsumable()
        Get the ItemStack to be consumed in this event (if any). For instance, bows will consume an arrow ItemStack in a player's inventory.
        Returns:
        the consumable item
      • getProjectile

        @NotNull
        public Entity getProjectile()
        Gets the projectile which will be launched by this event
        Returns:
        the launched projectile
      • setProjectile

        public void setProjectile​(@NotNull
                                  Entity projectile)
        Replaces the projectile which will be launched
        Parameters:
        projectile - the new projectile
      • getHand

        @NotNull
        public EquipmentSlot getHand()
        Get the hand from which the bow was shot.
        Returns:
        the hand
      • getForce

        public float getForce()
        Gets the force the arrow was launched with
        Returns:
        bow shooting force, up to 1.0
      • setConsumeItem

        public void setConsumeItem​(boolean consumeItem)
        Set whether or not the consumable item should be consumed in this event. If set to false, it is recommended that a call to Player.updateInventory() is made as the client may disagree with the server's decision to not consume a consumable item.

        This value is ignored for entities where items are not required (skeletons, pillagers, etc.) or with crossbows (as no item is being consumed).

        Parameters:
        consumeItem - whether or not to consume the item
      • shouldConsumeItem

        public boolean shouldConsumeItem()
        Get whether or not the consumable item should be consumed in this event.
        Returns:
        true if consumed, false otherwise
      • isCancelled

        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:
        true if this event is cancelled
      • setCancelled

        public void setCancelled​(boolean cancel)
        Description copied from interface: Cancellable
        Sets 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:
        setCancelled in interface Cancellable
        Parameters:
        cancel - true if you wish to cancel this event