Package org.spongepowered.api.entity

Interface Entity

All Superinterfaces:

CopyableDataHolder, DataHolder, DataHolder.Mutable, DataSerializable, EntityProjectileSource, HoverEventSource<HoverEvent.ShowEntity>, Identifiable, Locatable, ProjectileSource, RandomProvider, SerializableDataHolder, SerializableDataHolder.Mutable, Sound.Emitter, TeamMember, ValueContainer

All Known Subinterfaces:

Aerial, Ageable, Agent, Allay, Ambient, Animal, Aquatic, AreaEffectCloud, ArmorStand, Arrow, ArrowEntity, Axolotl, Bat, Bee, Blaze, BlockDisplay, BlockOccupiedMinecart, Boat, Boss, Camel, CarrierMinecart<M>, Cat, CaveSpider, ChestBoat, ChestMinecart, Chicken, ClientPlayer, Cod, CommandBlockMinecart, ComplexLiving<T>, ComplexLivingPart<P>, Cow, Creature, Creeper, DamagingProjectile, DisplayEntity, Dolphin, Donkey, DragonFireball, Drowned, Egg, ElderGuardian, EndCrystal, EnderDragon, EnderDragonPart, Enderman, Endermite, EnderPearl, EntityTargetingProjectile, Evoker, EvokerFangs, ExperienceBottle, ExperienceOrb, Explosive, ExplosiveFireball, EyeOfEnder, FallingBlock, FireballEntity, FireworkRocket, Fish, FishingBobber, Fox, Frog, FurnaceMinecart, FusedExplosive, Ghast, Giant, GlowSquid, Goat, Golem, Guardian, Hanging, Hoglin, HopperMinecart, Horse, HorseLike, Hostile, Human, Humanoid, Husk, Illager, Illusioner, Interaction, IronGolem, Item, ItemDisplay, ItemFrame, LeashKnot, LightningBolt, Living, Llama, LlamaLike, LlamaSpit, LocalPlayer, MagmaCube, Marker, Minecart, MinecartLike, Monster, Mooshroom, Mule, Ocelot, PackHorse, Painting, Panda, Parrot, Patroller, Phantom, Pig, Piglin, PiglinBrute, PiglinLike, Pillager, Player, PolarBear, Potion, PrimedTNT, Projectile, Pufferfish, Rabbit, Raider, Ranger, Ravager, RemotePlayer, Salmon, SchoolingFish, ServerPlayer, Sheep, Shulker, ShulkerBullet, Silverfish, Sittable, Skeleton, SkeletonHorse, SkeletonLike, Slime, SmallFireball, Sniffer, Snowball, SnowGolem, SpawnerMinecart, SpectralArrow, Spellcaster, Spider, Squid, Stray, Strider, Tadpole, TameableAnimal, TameableHorse, TextDisplay, TNTMinecart, Trader, TraderLlama, Trident, TropicalFish, Turtle, Vehicle, Vex, Villager, Vindicator, WanderingTrader, Warden, WeatherEffect, Witch, Wither, WitherSkeleton, WitherSkull, Wolf, Zoglin, Zombie, ZombieHorse, ZombieLike, ZombieVillager, ZombifiedPiglin

@DoNotStore
public interface Entity
extends Identifiable, HoverEventSource<HoverEvent.ShowEntity>, Locatable, EntityProjectileSource, Sound.Emitter, SerializableDataHolder.Mutable, RandomProvider, TeamMember

An entity is a Minecraft entity.

Examples of entities include:

• Zombies
• Sheep
• Players
• Dropped items
• Dropped experience points
• etc.

Blocks and items (when they are in inventories) are not entities.

Nested Class Summary

Nested classes/interfaces inherited from interface org.spongepowered.api.data.DataHolder

DataHolder.Immutable<I extends DataHolder.Immutable<I>>, DataHolder.Mutable

Nested classes/interfaces inherited from interface org.spongepowered.api.util.RandomProvider

RandomProvider.Source

Nested classes/interfaces inherited from interface org.spongepowered.api.data.SerializableDataHolder

SerializableDataHolder.Immutable<I extends SerializableDataHolder.Immutable<I>>, SerializableDataHolder.Mutable

Method Summary

Modifier and Type	Method	Description
default Value.Mutable<Integer>	age()	Keys.AGE
HoverEvent<HoverEvent.ShowEntity>	asHoverEvent(UnaryOperator<HoverEvent.ShowEntity> op)
default Value<Double>	baseSize()	Keys.BASE_SIZE
default Optional<Value<Entity>>	baseVehicle()	Keys.BASE_VEHICLE
Optional<AABB>	boundingBox()	Gets the entity's bounding box, usually for collisions and interaction.
default boolean	canSee(Entity entity)	Returns whether this entity can see the provided Entity.
Entity	copy()	Creates a clone copy of this CopyableDataHolder as a new CopyableDataHolder such that all the Values are safely duplicated to the new instance.
EntityArchetype	createArchetype()	Creates an EntityArchetype for use with Schematics.
EntitySnapshot	createSnapshot()	Creates an EntitySnapshot.
default Optional<Value.Mutable<UUID>>	creator()	Keys.CREATOR
default Optional<Value.Mutable<Component>>	customName()	Keys.CUSTOM_NAME
default Value.Mutable<Boolean>	customNameVisible()	Keys.IS_CUSTOM_NAME_VISIBLE
default boolean	damage(double damage, Supplier<? extends DamageSource> damageSource)	Damages this Entity with the given DamageSource.
boolean	damage(double damage, DamageSource damageSource)	Damages this Entity with the given DamageSource.
default Vector3d	direction()	Gets the unit vector representing the direction of this entity.
default Value.Mutable<Component>	displayName()	Keys.DISPLAY_NAME
default Value<Double>	eyeHeight()	Keys.EYE_HEIGHT
default Value<Vector3d>	eyePosition()	Keys.EYE_POSITION
default Value.Mutable<Double>	fallDistance()	Keys.FALL_DISTANCE
default Value.Mutable<Ticks>	fireImmuneTicks()	Keys.FIRE_DAMAGE_DELAY
default Optional<Value.Mutable<Ticks>>	fireTicks()	Keys.FIRE_TICKS
default Value.Mutable<Ticks>	frozenTime()	Keys.FROZEN_TIME
default Value.Mutable<Boolean>	glowing()	Keys.IS_GLOWING
default Value.Mutable<Boolean>	gravityAffected()	Keys.IS_GRAVITY_AFFECTED
default Value<Double>	height()	Keys.HEIGHT
default Value.Mutable<Boolean>	invisible()	Keys.IS_INVISIBLE
default Value.Mutable<Ticks>	invulnerabilityTicks()	Keys.INVULNERABILITY_TICKS
default Value.Mutable<Boolean>	invulnerable()	Keys.INVULNERABLE
boolean	isLoaded()	Returns whether this entity is still loaded in a world/chunk.
boolean	isRemoved()	Returns whether this entity has been removed.
default Value.Mutable<Boolean>	isTransient()	Keys.TRANSIENT
void	lookAt(Vector3d targetPos)	Makes the entity look at the specified target position.
default Value.Mutable<Integer>	maxAir()	Keys.MAX_AIR
default Value.Mutable<Ticks>	maxFrozenTime()	Keys.MAX_FROZEN_TIME
default Collection<? extends Entity>	nearbyEntities(double distance)	Gets the nearby entities within the desired distance.
default Collection<? extends Entity>	nearbyEntities(double distance, Predicate<? super Entity> predicate)	Gets the nearby entities that satisfy the desired predicate.
default Optional<Value.Mutable<UUID>>	notifier()	Keys.NOTIFIER
default Value<Boolean>	onGround()	Keys.ON_GROUND
default ListValue.Mutable<Entity>	passengers()	Keys.PASSENGERS
Vector3d	position()	Gets the position of this entity
default Value.Mutable<Integer>	remainingAir()	Keys.REMAINING_AIR
void	remove()	Mark this entity for removal in the very near future, preferably within one game tick.
Vector3d	rotation()	Gets the rotation.
Vector3d	scale()	Gets the scale.
default SetValue.Mutable<String>	scoreboardTags()	Keys.SCOREBOARD_TAGS
boolean	setLocation(ServerLocation location)	Sets the location of this entity.
boolean	setLocationAndRotation(ServerLocation location, Vector3d rotation)	Moves the entity to the specified location and sets the rotation.
boolean	setLocationAndRotation(ServerLocation location, Vector3d rotation, EnumSet<RelativePositions> relativePositions)	Moves the entity to the specified location and sets the rotation.
boolean	setPosition(Vector3d position)	Sets the position of this entity.
void	setRotation(Vector3d rotation)	Sets the rotation of this entity.
void	setScale(Vector3d scale)	Sets the scale.
boolean	setTransform(Transform transform)	Sets the Transform.
default Value.Mutable<Boolean>	silent()	Keys.IS_SILENT
default Value.Mutable<Boolean>	sneaking()	Keys.IS_SNEAKING
default Value.Mutable<Boolean>	sprinting()	Keys.IS_SPRINTING
default Optional<Value.Mutable<Double>>	swiftness()	Keys.SWIFTNESS
default boolean	transferToWorld(ServerWorld world)	Sets the ServerLocation of this entity to the ServerWorld's spawn point.
boolean	transferToWorld(ServerWorld world, Vector3d position)	Sets the ServerLocation of this entity to a new position in a world.
Transform	transform()	Gets the Transform.
EntityType<?>	type()	Gets the EntityType.
default Value.Mutable<VanishState>	vanishState()	Keys.VANISH_STATE
default Optional<Value.Mutable<Entity>>	vehicle()	Keys.VEHICLE
default Value.Mutable<Vector3d>	velocity()	Keys.VELOCITY
default Value<Boolean>	wet()	Keys.IS_WET

Methods inherited from interface org.spongepowered.api.data.DataHolder.Mutable

copyFrom, copyFrom, offer, offer, offer, offer, offerAll, offerAll, offerAll, offerAll, offerAll, offerAll, offerSingle, offerSingle, offerSingle, offerSingle, remove, remove, remove, removeAll, removeAll, removeAll, removeAll, removeAll, removeAll, removeKey, removeKey, removeSingle, removeSingle, transform, transform, tryOffer, tryOffer, tryOffer, undo

Methods inherited from interface org.spongepowered.api.data.persistence.DataSerializable

contentVersion, toContainer

Methods inherited from interface net.kyori.adventure.text.event.HoverEventSource

asHoverEvent

Methods inherited from interface org.spongepowered.api.util.Identifiable

uniqueId

Methods inherited from interface org.spongepowered.api.world.Locatable

blockPosition, location, serverLocation, world

Methods inherited from interface org.spongepowered.api.projectile.source.ProjectileSource

launchProjectile, launchProjectile, launchProjectile, launchProjectile, launchProjectileTo, launchProjectileTo

Methods inherited from interface org.spongepowered.api.util.RandomProvider

random

Methods inherited from interface org.spongepowered.api.data.SerializableDataHolder

validateRawData

Methods inherited from interface org.spongepowered.api.data.SerializableDataHolder.Mutable

setRawData

Methods inherited from interface org.spongepowered.api.scoreboard.TeamMember

teamRepresentation

Methods inherited from interface org.spongepowered.api.data.value.ValueContainer

get, getDouble, getInt, getKeys, getLong, getOrElse, getOrNull, getValue, getValues, require, requireValue, supports, supports

Method Details

type

EntityType<?> type()

Gets the EntityType.

Returns:

The type

createSnapshot

EntitySnapshot createSnapshot()

Creates an EntitySnapshot.

Returns:

The snapshot

copy

Entity copy()

Description copied from interface: CopyableDataHolder

Creates a clone copy of this CopyableDataHolder as a new CopyableDataHolder such that all the Values are safely duplicated to the new instance. It is not guaranteed that the returning container is of the same type as this container.

Specified by:

copy in interface CopyableDataHolder

Specified by:

copy in interface SerializableDataHolder

Specified by:

copy in interface SerializableDataHolder.Mutable

Returns:

The new copy

createArchetype

EntityArchetype createArchetype()

Creates an EntityArchetype for use with Schematics.

Returns:

The archetype

position

Vector3d position()

Gets the position of this entity

Returns:

The position of this entity

setPosition

boolean setPosition(Vector3d position)

Sets the position of this entity.

Parameters:

position - The position to set

Returns:

True if set, false if not

setLocation

boolean setLocation(ServerLocation location)

Sets the location of this entity.

Parameters:

location - The location to set

Returns:

True if location was set successfully, false otherwise

rotation

Vector3d rotation()

Gets the rotation.

The format of the rotation is represented by:

x -> pitch, y -> yaw, z -> roll

Returns:

The rotation

setRotation

void setRotation(Vector3d rotation)

Sets the rotation of this entity.

The format of the rotation is represented by:

x -> pitch, y -> yaw, z -> roll

Parameters:

rotation - The rotation to set the entity to

direction

default Vector3d direction()

Gets the unit vector representing the direction of this entity.

Returns:

The direction

setLocationAndRotation

boolean setLocationAndRotation(ServerLocation location,
 Vector3d rotation)

Moves the entity to the specified location and sets the rotation.

The format of the rotation is represented by:

x -> pitch, y -> yaw, z -> roll

Parameters:

location - The location to set

rotation - The rotation to set

Returns:

True if location was set successfully, false otherwise

setLocationAndRotation

boolean setLocationAndRotation(ServerLocation location,
 Vector3d rotation,
 EnumSet<RelativePositions> relativePositions)

Moves the entity to the specified location and sets the rotation. RelativePositions listed inside the EnumSet are considered relative.

The format of the rotation is represented by:

x -> pitch, y -> yaw, z -> roll

Parameters:

location - The location to set

rotation - The rotation to set

relativePositions - The coordinates to set relatively

Returns:

True if location was set successfully, false otherwise

scale

Vector3d scale()

Gets the scale.

Returns:

The entity scale

setScale

void setScale(Vector3d scale)

Sets the scale.

Parameters:

scale - The scale

transform

Transform transform()

Gets the Transform.

Returns:

The transform

setTransform

boolean setTransform(Transform transform)

Sets the Transform.

Parameters:

transform - The transform to set

Returns:

True if the transform was set successfully, false if the transform couldn't be set

transferToWorld

default boolean transferToWorld(ServerWorld world)

Sets the ServerLocation of this entity to the ServerWorld's spawn point.

Parameters:

world - The world to transfer to

Returns:

Whether the transfer was successful, returns false if the action is cancelled or not possible (eg. because the entity has been removed)

transferToWorld

boolean transferToWorld(ServerWorld world,
 Vector3d position)

Sets the ServerLocation of this entity to a new position in a world.

Parameters:

world - The world to transfer to

position - The position in the target world

Returns:

Whether the transfer was successful, returns false if the action is cancelled or not possible (eg. because the entity has been removed)

boundingBox

Optional<AABB> boundingBox()

Gets the entity's bounding box, usually for collisions and interaction. The box has an offset matching the entity's positions. That is to say, it is absolutely positioned and not relative to the entity.

Returns:

The axis aligned bounding box

isRemoved

boolean isRemoved()

Returns whether this entity has been removed.

Returns:

True if this entity has been removed

isLoaded

boolean isLoaded()

Returns whether this entity is still loaded in a world/chunk.

Returns:

True if this entity is still loaded

remove

void remove()

Mark this entity for removal in the very near future, preferably within one game tick.

damage

default boolean damage(double damage,
 Supplier<? extends DamageSource> damageSource)

Damages this Entity with the given DamageSource.

Parameters:

damage - The damage to deal

damageSource - The cause of the damage

Returns:

True if damaging the entity was successful

damage

boolean damage(double damage,
 DamageSource damageSource)

Damages this Entity with the given DamageSource.

Parameters:

damage - The damage to deal

damageSource - The cause of the damage

Returns:

True if damaging the entity was successful

nearbyEntities

default Collection<? extends Entity> nearbyEntities(double distance)

Gets the nearby entities within the desired distance.

Parameters:

distance - The distance

Returns:

The collection of nearby entities

See Also:

• EntityVolume.nearbyEntities(Vector3d, double)

nearbyEntities

default Collection<? extends Entity> nearbyEntities(double distance,
 Predicate<? super Entity> predicate)

Gets the nearby entities that satisfy the desired predicate.

Parameters:

distance - The distance

predicate - The predicate to use

Returns:

The collection of entities

See Also:

• EntityVolume.entities(AABB, Predicate)

canSee

default boolean canSee(Entity entity)

Returns whether this entity can see the provided Entity.

Parameters:

entity - The entity to check visibility for

Returns:

true if this entity can see the provided entity

lookAt

void lookAt(Vector3d targetPos)

Makes the entity look at the specified target position.

Parameters:

targetPos - Position to target

displayName

default Value.Mutable<Component> displayName()

Keys.DISPLAY_NAME

Returns:

The display name of this entity

fallDistance

default Value.Mutable<Double> fallDistance()

Keys.FALL_DISTANCE

Returns:

The fall distance

frozenTime

default Value.Mutable<Ticks> frozenTime()

Keys.FROZEN_TIME

Returns:

The frozen time

passengers

default ListValue.Mutable<Entity> passengers()

Keys.PASSENGERS

Returns:

The list of passengers that may be riding this entity

vehicle

default Optional<Value.Mutable<Entity>> vehicle()

Keys.VEHICLE

Returns:

The vehicle this entity may be riding

baseVehicle

default Optional<Value<Entity>> baseVehicle()

Keys.BASE_VEHICLE

Returns:

The "base vehicle" of the entity vehicle riding chain

onGround

default Value<Boolean> onGround()

Keys.ON_GROUND

Returns:

Whether this entity is on the ground

velocity

default Value.Mutable<Vector3d> velocity()

Keys.VELOCITY

Returns:

The velocity of this entity

gravityAffected

default Value.Mutable<Boolean> gravityAffected()

Keys.IS_GRAVITY_AFFECTED

Returns:

Whether this entity is affected by gravity

silent

default Value.Mutable<Boolean> silent()

Keys.IS_SILENT

Returns:

Whether this entity is silent

creator

default Optional<Value.Mutable<UUID>> creator()

Keys.CREATOR

Returns:

The unique id of the creator of this entity

notifier

default Optional<Value.Mutable<UUID>> notifier()

Keys.NOTIFIER

Returns:

The unique id of the notifier of this entity

fireTicks

default Optional<Value.Mutable<Ticks>> fireTicks()

Keys.FIRE_TICKS

Returns:

The amount of time in ticks the entity is will continue burn for

fireImmuneTicks

default Value.Mutable<Ticks> fireImmuneTicks()

Keys.FIRE_DAMAGE_DELAY

Returns:

The amount of time to delay in ticks before the entity will be burned by fire

isTransient

default Value.Mutable<Boolean> isTransient()

Keys.TRANSIENT

Returns:

The transient state

age

default Value.Mutable<Integer> age()

Keys.AGE

Returns:

The age of this entity

baseSize

default Value<Double> baseSize()

Keys.BASE_SIZE

Returns:

The base size of the entity

eyeHeight

default Value<Double> eyeHeight()

Keys.EYE_HEIGHT

Returns:

The height of the eyes

eyePosition

default Value<Vector3d> eyePosition()

Keys.EYE_POSITION

Returns:

The position of the eyes

height

default Value<Double> height()

Keys.HEIGHT

Returns:

The height of the entity

invulnerabilityTicks

default Value.Mutable<Ticks> invulnerabilityTicks()

Keys.INVULNERABILITY_TICKS

Returns:

The amount of ticks the entity will remain invulnerable for

customNameVisible

default Value.Mutable<Boolean> customNameVisible()

Keys.IS_CUSTOM_NAME_VISIBLE

Returns:

Whether a custom name is visible on the entity

glowing

default Value.Mutable<Boolean> glowing()

Keys.IS_GLOWING

Returns:

Whether the entity has a glowing outline

invisible

default Value.Mutable<Boolean> invisible()

Keys.IS_INVISIBLE

Returns:

Whether the entity is currently invisible

invulnerable

default Value.Mutable<Boolean> invulnerable()

Keys.INVULNERABLE

Returns:

Whether the entity is invulnerable

sneaking

default Value.Mutable<Boolean> sneaking()

Keys.IS_SNEAKING

Returns:

Whether the entity is sneaking

sprinting

default Value.Mutable<Boolean> sprinting()

Keys.IS_SPRINTING

Returns:

Whether the entity is sprinting

wet

default Value<Boolean> wet()

Keys.IS_WET

Returns:

Whether the entity is wet

maxAir

default Value.Mutable<Integer> maxAir()

Keys.MAX_AIR

Returns:

The max air supply

maxFrozenTime

default Value.Mutable<Ticks> maxFrozenTime()

Keys.MAX_FROZEN_TIME

Returns:

The max frozen time

remainingAir

default Value.Mutable<Integer> remainingAir()

Keys.REMAINING_AIR

Returns:

The remaining air supply

scoreboardTags

default SetValue.Mutable<String> scoreboardTags()

Keys.SCOREBOARD_TAGS

Returns:

The scoreboard tags applied to the entity

vanishState

default Value.Mutable<VanishState> vanishState()

Keys.VANISH_STATE

Returns:

The current vanish state of the entity

customName

default Optional<Value.Mutable<Component>> customName()

Keys.CUSTOM_NAME

Returns:

The custom name of the entity

swiftness

default Optional<Value.Mutable<Double>> swiftness()

Keys.SWIFTNESS

Returns:

The current swiftness of the entity

asHoverEvent

HoverEvent<HoverEvent.ShowEntity> asHoverEvent(UnaryOperator<HoverEvent.ShowEntity> op)

Specified by:

asHoverEvent in interface HoverEventSource<HoverEvent.ShowEntity>