Package org.bukkit.event.entity

Class EntityKnockbackEvent

java.lang.Object

org.bukkit.event.Event

org.bukkit.event.entity.EntityEvent

org.bukkit.event.entity.EntityKnockbackEvent

All Implemented Interfaces:

Cancellable

Direct Known Subclasses:

EntityKnockbackByEntityEvent

public class EntityKnockbackEvent
extends EntityEvent
implements Cancellable

Called when a living entity receives knockback.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	EntityKnockbackEvent.KnockbackCause	An enum to specify the cause of the knockback.

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

Event.Result

Field Summary

Fields inherited from class org.bukkit.event.entity.EntityEvent

entity

Constructor Summary

Constructors

Constructor	Description
EntityKnockbackEvent(LivingEntity entity, EntityKnockbackEvent.KnockbackCause cause, double force, Vector rawKnockback, Vector knockback)

Method Summary

Modifier and Type	Method	Description
EntityKnockbackEvent.KnockbackCause	getCause()	Gets the cause of the knockback.
LivingEntity	getEntity()	Returns the Entity involved in this event
Vector	getFinalKnockback()	Gets the force that will be applied to the entity.
double	getForce()	Gets the raw force of the knockback.
static HandlerList	getHandlerList()
HandlerList	getHandlers()
Vector	getKnockback()	Gets the raw knockback force that will be applied to the entity.
boolean	isCancelled()	Gets the cancellation state of this event.
void	setCancelled(boolean cancel)	Sets the cancellation state of this event.
void	setFinalKnockback(Vector knockback)	Sets the force that will be applied to the entity.

Methods inherited from class org.bukkit.event.entity.EntityEvent

getEntityType

Methods inherited from class org.bukkit.event.Event

getEventName, isAsynchronous

Methods inherited from class java.lang.Object

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

Constructor Details

EntityKnockbackEvent

public EntityKnockbackEvent(@NotNull
 LivingEntity entity,
 @NotNull
 EntityKnockbackEvent.KnockbackCause cause,
 double force,
 @NotNull
 Vector rawKnockback,
 @NotNull
 Vector knockback)

Method Details

getEntity

@NotNull
public LivingEntity getEntity()

Description copied from class: EntityEvent

Returns the Entity involved in this event

Overrides:

getEntity in class EntityEvent

Returns:

Entity who is involved in this event

getCause

@NotNull
public EntityKnockbackEvent.KnockbackCause getCause()

Gets the cause of the knockback.

Returns:

the cause of the knockback

getForce

public double getForce()

Gets the raw force of the knockback.
This value is based on factors such as the Enchantment.KNOCKBACK level of an attacker and the Attribute.KNOCKBACK_RESISTANCE of the entity.

Returns:

the knockback force

getKnockback

@NotNull
public Vector getKnockback()

Gets the raw knockback force that will be applied to the entity.
This value is read-only, changes made to it will not have any effect on the final knockback received.

Returns:

the raw knockback

See Also:

• getFinalKnockback()

getFinalKnockback

@NotNull
public Vector getFinalKnockback()

Gets the force that will be applied to the entity.
In contrast to getKnockback() this value is affected by the entities current velocity and whether they are touching the ground.

Note: this method returns a copy, changes must be applied with setFinalKnockback(Vector).

Returns:

the final knockback

setFinalKnockback

@NotNull
public void setFinalKnockback(@NotNull
 Vector knockback)

Sets the force that will be applied to the entity.

Parameters:

knockback - the force to apply

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

getHandlers

@NotNull
public HandlerList getHandlers()

Specified by:

getHandlers in class Event

getHandlerList

@NotNull
public static HandlerList getHandlerList()