org.bukkit.entity
Interface Entity

All Superinterfaces:

Metadatable

All Known Subinterfaces:

Ageable, Ambient, Animals, Arrow, Bat, Blaze, Boat, CaveSpider, Chicken, CommandMinecart, ComplexEntityPart, ComplexLivingEntity, Cow, Creature, Creeper, Damageable, Egg, EnderCrystal, EnderDragon, EnderDragonPart, Enderman, EnderPearl, EnderSignal, ExperienceOrb, Explosive, ExplosiveMinecart, FallingBlock, FallingSand, Fireball, Firework, Fish, FishHook, Flying, Ghast, Giant, Golem, Hanging, HopperMinecart, Horse, HumanEntity, IronGolem, Item, ItemFrame, LargeFireball, LeashHitch, LightningStrike, LivingEntity, MagmaCube, Minecart, Monster, MushroomCow, NPC, Ocelot, Painting, Pig, PigZombie, Player, PoweredMinecart, PoweredMinecart, Projectile, RideableMinecart, Sheep, Silverfish, Skeleton, Slime, SmallFireball, Snowball, Snowman, SpawnerMinecart, Spider, Squid, StorageMinecart, StorageMinecart, ThrownExpBottle, ThrownPotion, TNTPrimed, Vehicle, Villager, WaterMob, Weather, Witch, Wither, WitherSkull, Wolf, Zombie

public interface Entity
extends Metadatable

Represents a base entity in the world

Method Summary

boolean	eject() Eject any passenger.
int	getEntityId() Returns a unique id for this entity
float	getFallDistance() Returns the distance this entity has fallen
int	getFireTicks() Returns the entity's current fire ticks (ticks before the entity stops being on fire).
EntityDamageEvent	getLastDamageCause() Retrieve the last EntityDamageEvent inflicted on this entity.
Location	getLocation() Gets the entity's current position
Location	getLocation(Location loc) Stores the entity's current position in the provided Location object.
int	getMaxFireTicks() Returns the entity's maximum fire ticks.
List<Entity>	getNearbyEntities(double x, double y, double z) Returns a list of entities within a bounding box centered around this entity
Entity	getPassenger() Gets the primary passenger of a vehicle.
Server	getServer() Gets the Server that contains this Entity
int	getTicksLived() Gets the amount of ticks this entity has lived for.
EntityType	getType() Get the type of the entity.
UUID	getUniqueId() Returns a unique and persistent id for this entity
Entity	getVehicle() Get the vehicle that this player is inside.
Vector	getVelocity() Gets this entity's current velocity
World	getWorld() Gets the current world this entity resides in
boolean	isDead() Returns true if this entity has been marked for removal.
boolean	isEmpty() Check if a vehicle has passengers.
boolean	isInsideVehicle() Returns whether this entity is inside a vehicle.
boolean	isOnGround() Returns true if the entity is supported by a block.
boolean	isValid() Returns false if the entity has died or been despawned for some other reason.
boolean	leaveVehicle() Leave the current vehicle.
void	playEffect(EntityEffect type) Performs the specified EntityEffect for this entity.
void	remove() Mark the entity's removal.
void	setFallDistance(float distance) Sets the fall distance for this entity
void	setFireTicks(int ticks) Sets the entity's current fire ticks (ticks before the entity stops being on fire).
void	setLastDamageCause(EntityDamageEvent event) Record the last EntityDamageEvent inflicted on this entity
boolean	setPassenger(Entity passenger) Set the passenger of a vehicle.
void	setTicksLived(int value) Sets the amount of ticks this entity has lived for.
void	setVelocity(Vector velocity) Sets this entity's velocity
boolean	teleport(Entity destination) Teleports this entity to the target Entity.
boolean	teleport(Entity destination, PlayerTeleportEvent.TeleportCause cause) Teleports this entity to the target Entity.
boolean	teleport(Location location) Teleports this entity to the given location.
boolean	teleport(Location location, PlayerTeleportEvent.TeleportCause cause) Teleports this entity to the given location.

Methods inherited from interface org.bukkit.metadata.Metadatable

getMetadata, hasMetadata, removeMetadata, setMetadata

Method Detail

getLocation

Location getLocation()

Gets the entity's current position

Returns:

a new copy of Location containing the position of this entity

getLocation

Location getLocation(Location loc)

Stores the entity's current position in the provided Location object.

If the provided Location is null this method does nothing and returns null.

Returns:

The Location object provided or null

setVelocity

void setVelocity(Vector velocity)

Sets this entity's velocity

Parameters:

velocity - New velocity to travel with

getVelocity

Vector getVelocity()

Gets this entity's current velocity

Returns:

Current travelling velocity of this entity

isOnGround

boolean isOnGround()

Returns true if the entity is supported by a block. This value is a state updated by the server and is not recalculated unless the entity moves.

Returns:

True if entity is on ground.

getWorld

World getWorld()

Gets the current world this entity resides in

Returns:

World

teleport

boolean teleport(Location location)

Teleports this entity to the given location. If this entity is riding a vehicle, it will be dismounted prior to teleportation.

Parameters:

location - New location to teleport this entity to

Returns:

true if the teleport was successful

teleport

boolean teleport(Location location,
                 PlayerTeleportEvent.TeleportCause cause)

Teleports this entity to the given location. If this entity is riding a vehicle, it will be dismounted prior to teleportation.

Parameters:

location - New location to teleport this entity to

cause - The cause of this teleportation

Returns:

true if the teleport was successful

teleport

boolean teleport(Entity destination)

Teleports this entity to the target Entity. If this entity is riding a vehicle, it will be dismounted prior to teleportation.

Parameters:

destination - Entity to teleport this entity to

Returns:

true if the teleport was successful

teleport

boolean teleport(Entity destination,
                 PlayerTeleportEvent.TeleportCause cause)

Teleports this entity to the target Entity. If this entity is riding a vehicle, it will be dismounted prior to teleportation.

Parameters:

destination - Entity to teleport this entity to

cause - The cause of this teleportation

Returns:

true if the teleport was successful

getNearbyEntities

List<Entity> getNearbyEntities(double x,
                               double y,
                               double z)

Returns a list of entities within a bounding box centered around this entity

Parameters:

x - 1/2 the size of the box along x axis

y - 1/2 the size of the box along y axis

z - 1/2 the size of the box along z axis

Returns:

List List of entities nearby

getEntityId

int getEntityId()

Returns a unique id for this entity

Returns:

Entity id

getFireTicks

int getFireTicks()

Returns the entity's current fire ticks (ticks before the entity stops being on fire).

Returns:

int fireTicks

getMaxFireTicks

int getMaxFireTicks()

Returns the entity's maximum fire ticks.

Returns:

int maxFireTicks

setFireTicks

void setFireTicks(int ticks)

Sets the entity's current fire ticks (ticks before the entity stops being on fire).

Parameters:

ticks - Current ticks remaining

remove

void remove()

Mark the entity's removal.

isDead

boolean isDead()

Returns true if this entity has been marked for removal.

Returns:

True if it is dead.

isValid

boolean isValid()

Returns false if the entity has died or been despawned for some other reason.

Returns:

True if valid.

getServer

Server getServer()

Gets the Server that contains this Entity

Returns:

Server instance running this Entity

getPassenger

Entity getPassenger()

Gets the primary passenger of a vehicle. For vehicles that could have multiple passengers, this will only return the primary passenger.

Returns:

an entity

setPassenger

boolean setPassenger(Entity passenger)

Set the passenger of a vehicle.

Parameters:

passenger - The new passenger.

Returns:

false if it could not be done for whatever reason

isEmpty

boolean isEmpty()

Check if a vehicle has passengers.

Returns:

True if the vehicle has no passengers.

eject

boolean eject()

Eject any passenger.

Returns:

True if there was a passenger.

getFallDistance

float getFallDistance()

Returns the distance this entity has fallen

Returns:

The distance.

setFallDistance

void setFallDistance(float distance)

Sets the fall distance for this entity

Parameters:

distance - The new distance.

setLastDamageCause

void setLastDamageCause(EntityDamageEvent event)

Record the last EntityDamageEvent inflicted on this entity

Parameters:

event - a EntityDamageEvent

getLastDamageCause

EntityDamageEvent getLastDamageCause()

Retrieve the last EntityDamageEvent inflicted on this entity. This event may have been cancelled.

Returns:

the last known EntityDamageEvent or null if hitherto unharmed

getUniqueId

UUID getUniqueId()

Returns a unique and persistent id for this entity

Returns:

unique id

getTicksLived

int getTicksLived()

Gets the amount of ticks this entity has lived for.

This is the equivalent to "age" in entities.

Returns:

Age of entity

setTicksLived

void setTicksLived(int value)

Sets the amount of ticks this entity has lived for.

This is the equivalent to "age" in entities. May not be less than one tick.

Parameters:

value - Age of entity

playEffect

void playEffect(EntityEffect type)

Performs the specified EntityEffect for this entity.

This will be viewable to all players near the entity.

Parameters:

type - Effect to play.

getType

EntityType getType()

Get the type of the entity.

Returns:

The entity type.

isInsideVehicle

boolean isInsideVehicle()

Returns whether this entity is inside a vehicle.

Returns:

True if the entity is in a vehicle.

leaveVehicle

boolean leaveVehicle()

Leave the current vehicle. If the entity is currently in a vehicle (and is removed from it), true will be returned, otherwise false will be returned.

Returns:

True if the entity was in a vehicle.

getVehicle

Entity getVehicle()

Get the vehicle that this player is inside. If there is no vehicle, null will be returned.

Returns:

The current vehicle.