Entity

From Minecraft Wiki
Jump to: navigation, search
A player standing in front of a large group of entities
The hitboxes of several entities. Note the blue line that points to the direction the entity is "facing."

Entities encompass all dynamic, moving objects throughout the Minecraft world.

General behavior[edit]

Properties all entities have are:

  • A position, rotation, and velocity, as according to Newtonian mechanics
  • A volume consisting of one or more non-rotating, three-dimensional boxes with a fixed height and width
  • Whether they are on fire, displayed as flames on or around the entity
  • Whether they have any status effect, such as from potions

Most entities can be pushed around by water currents, and some can have their trajectory altered by explosions if already traveling at speed. Some entities can be renamed by using a name tag on them. Entity tiles, items, shot or thrown projectiles, area effect clouds, and experience orbs do not have a current health. Entities that do have a health status include mobs, players, boats and minecarts.

Entities cannot pass through solid blocks, excluding vexes. Most types of entities prevent blocks from being placed in the space they occupy, except for resources (dropped items) and experience orbs, which are automatically pushed out of the block to open air. If a solid block enters an entity's space, such as falling sand or a swinging door, then it is free to move out of the solid block but not back in. For example, if a door is closed on you, you can jump up and stand on top of the bottom-half door block, if there is air above the door.

Entities are lit according to the light level of the block their position is in. For example, if a minecart runs over a non-straight track directly into a solid block, it turns black because solid blocks always have a light level of 0; arrows are also sometimes seen to turn black, especially if fired shallowly into the ceiling.

Further notes[edit]

Item frames, paintings, and lead knots, unlike most entities, align to the block grid, and are completely immobile.

Arrows, TNT and falling sand (and its variants, including other falling blocks like anvils and dragon eggs) are assumed to have infinite health because they are not destroyed by explosions (although they can be moved by explosions, and they can also be fired out of TNT cannons), nor by being on fire for long periods. However, they can still be "killed" with the use of the /kill command.

When a block is placed on some entities, the block may disappear but might be restored if placed again.[needs testing]

Boats and minecarts[edit]

See also: Transportation (contains information about speed)

Boats and minecarts appear to recover health over time. For example, they can be broken by hitting them quickly, but cannot be destroyed by hits with unarmed hand with a pause after each hit. The amount of wobbling displayed by boats and minecarts when struck appears to indicate their current health. All minecart and boat variants have 6♥♥♥.

Gravity-affected blocks[edit]

Main article: Falling Block
Falling sand that collapsed into a dungeon.

Gravity-affected blocks include sand, gravel, anvils, red sand, dragon eggs, concrete powder, scaffolding and pointed dripstone[upcoming: JE 1.17 & BE 1.17.0], and also snow layers in Bedrock Edition.

A gravity-affected block normally exists as a block, but when its support is removed, it becomes a falling block entity and falls down until hitting the top surface of another block. If there is valid space, it places itself as a block at the nearest on-grid position, or drops as an item if that position is occupied by a block without a solid top surface, such as a torch or a bottom slab.

While a falling block ordinarily fall straight down, its trajectory can be affected by explosions, bubble columns, pistons and moving slime blocks, and can slide down the side of honey blocks. It is also possible to modify the velocity and direction of a falling block by using commands such as /data[Java Edition only] or third-party programs, although there are no in-game mechanics that can change a falling block's facing direction. A falling block despawns and drops as an item if it does not land after existing for 600 ticks (30 seconds), or 100 ticks (5 seconds) if falling into the void[verify].

If a cave generates underneath sand, gravel or red sand, the blocks remain stationary until it receives a block update. If a single block is updated and falls down, neighboring blocks will be updated in a chain reaction which can cause the collapse of an entire region of gravity-affected blocks.

Interactions with "use" control[edit]

Entities with use interactions (such as boats, minecarts, cats, villagers, tamed parrots, and tamed wolves) do not stop the use action of a tool you are holding. For example, using a water bucket on a tamed wolf causes the wolf to sit, but also empties the bucket near or onto the wolf.

Riding[edit]

A spider jockey.

Entities may be riding on, or attached to, other entities. When this is the case, only the lower/"outer" entity's volume collides with other things, and only that entity can control movement.‌[Java Edition only] However, there are exceptions: players riding minecarts, boats or saddled horses, baby zombies riding chickens, and skeletons riding horses or boats. The only current legitimate combinations of riding entities are:

It is possible to have multiple levels, such as two parrots on the player's shoulder who is riding a horse in a minecart in a boat.

Entities can also be stacked on top of each other with the use of the /summon and /data commands. For example, using /summon spider ~ ~ ~ {Passengers:[{id:skeleton}]} summons a spider jockey.

If an entity is riding another entity, the top entity cannot teleport because as soon as the teleport is made, the entity is teleported back to riding the other entity.‌[Java Edition only] Since Minecraft smooths out movements by showing entities at locations between new and old positions, this may result in seeing the entity at several locations between riding the other entity and their teleport location.

When solid blocks are placed on an entity, they prevent blocks from being placed in the space they occupy.

Types of entities[edit]

The table below lists types of entities that currently exist in Minecraft.

Entities listed as "solid" obstruct the passage of other entities.

The size is in block lengths (measured in meters; note that 1 block is 1m3), and is the size of an axis-aligned bounding box with the specified width in both horizontal dimensions (X and Z) and the specified height in the Y dimension. This box does not rotate when the object rotates visually.

For a list of numeric entity IDs, see Java Edition data values#Entities.

Type Solid Drops Despawns Health Width × Height Network ID Namespaced ID Notes
Players Yes Their inventory (unless gamerule keepInventory is set to true) No, but the character disappears when the player leaves game 20♥ × 10 (Varies with attributes) 0.6×1.8 (varies)

Note: Players also become un-rendered around 64 blocks away

Mobs Yes see Drops see Spawn Varies Varies see Entity IDs see Entity IDs
Camera[Education and Bedrock editions only] Yes After taking a picture 4♥♥ ? ?
Ice Bomb[Education and Bedrock editions only] Yes (to water) When It hits water or after being in the air for a few minutes. 0.25 x 0.25 ? ? Transforms water into ice when it hits water.
Balloon[Education and Bedrock editions only] Yes When pop out ? ? Levitate passive mob into air.

Boats
Yes Drops if hit by a player or mob or if broken by a cactus or lava No 6♥♥♥ 1.5×0.6 41 boat Recovers health quickly over time.

Minecart
Yes (to other entities) 1 minecart No 6♥♥♥ 0.98×0.7 42 minecart Recovers health quickly over time.
Snaps to rails if in a block occupied by them.

Minecart with Chest
Yes (to other entities) 1 minecart, 1 chest, contents of chest if any No 6♥♥♥ 0.98×0.7 43 chest_minecart

Minecart with Furnace
Yes (to other entities) 1 minecart, 1 furnace No 6♥♥♥ 0.98×0.7 44 furnace_minecart

Minecart with TNT
Yes (to other entities) 1 minecart, 1 TNT (unless exploded) No 6♥♥♥ 0.98×0.7 45 tnt_minecart

Minecart with Hopper
Yes (to other entities) 1 minecart, 1 hopper, contents of hopper if any No 6♥♥♥ 0.98×0.7 46 hopper_minecart

Minecart with Spawner[Java Edition only]
Yes (to other entities) 1 minecart No 6♥♥♥ 0.98×0.7 47 spawner_minecart

Minecart with Command Block
Yes (to other entities) 1 minecart No 6♥♥♥ 0.98×0.7 40 command_block_minecart
Items Yes (to boats and minecarts) 5 minutes 5♥♥♥ 0.25×0.25 1 item Destroyed by explosions, fire, lava, cacti, and falling anvils, but cannot be struck. One exception is the Nether Star, which cannot be blown up. Netherite blocks (except for the lodestone) are also immune to explosions, fire, and lava, with the items themselves being immune to fire and lava.
Experience orbs No 5 minutes 5♥♥♥ 0.3×0.3 2 xp_orb Same behaviors as dropped items; also attracted to the player.
Arrows Yes (to boats and minecarts) 1 minute 0.5×0.5 10 arrow, spectral_arrow Damages other entities if moving; harmless when stuck in a block (but gets launched again and deals damage if that block is destroyed). Can be picked up if fired by a player in Survival mode (except if shot with an infinity bow).
Tridents Yes N/A 1 minute 0.5×0.5 ? trident Similar behavior as arrows.
Snowball Yes N/A No 0.25×0.25 11 snowball
Egg Yes N/A No 0.25×0.25 7 egg 12.5% chance to spawn a baby chicken on impact.
Llama spit Yes N/A No 0.25×0.25 68 llama_spit
Ender pearls Yes N/A No 0.25×0.25 14 ender_pearl Teleports player on impact and deals 5♥♥♥ of fall damage
Eye of ender No Eye of ender after flight (20% or 1:5 chance of shattering) No 0.25×0.25 15 eye_of_ender_signal Floats toward the end portal in the closest stronghold.
Firework rocket No Varies (explodes) ? 22 fireworks_rocket
Primed TNT No 4 seconds or fewer
(Explodes)
0.98×0.98 20 tnt
Falling blocks No Itself as an item if hits a non-solid block, or is placed if on a solid block Once entity hits ground or ~4 seconds 0.98×0.98 21 falling_block Drops itself when landing in a non-solid block such as a torch.
Fishing rod bobbers Yes (to boats and minecarts) 1 minute ?
Lightning bolts No 1-3 ticks ?
Lead knot No 1 Lead No ? 8 leash_knot Drops as an item when struck
Painting No 1 painting No Varies 9 painting Drops as an item when struck
Item frame No 1 item frame and displayed item (if displaying) No ? 10 item_frame Drops as an item when struck
Armor stand No 1 armor stand and displayed items (if displaying) No ? 30 armor_stand Drops as an item when struck
Fireballs
Wither skulls
Dragon Fireballs
Yes 1 minute or when it collides 1.0×1.0 (Ghast), 0.3125×0.3125 (Blaze/Wither) 12, 13, 19, 26 fireball,

small_fireball,

wither_skull,

dragon_fireball

Shulker bullet Yes No ? 67 shulker_bullet
End crystals No No 5♥♥♥ 1×1 solid (the bedrock part when generated in the End) and 2×2 textured 200 end_crystal Explodes when damage is done in any form
Evoker fangs No 1-2 seconds ? ? JE: 79
BE: 103
evoker_fangs

Motion of entities[edit]

"Gravity" redirects here. For the Minecraft Dungeons enchantment, see MCD:Gravity.

Gravity works differently in Minecraft than the real world, as not everything is subject to the same acceleration. Additionally, there is a drag force proportional to velocity, again dependent on the entity.

Kind Acceleration
blocks/tick2
Acceleration
m/s2
Drag
1/tick
Terminal velocity
blocks/tick
Terminal velocity
m/s
Players and other living entities [note 1] 0.08 32 0.02 3.92 78.4
Players/mobs with Slow Falling [note 1] 0.01 4 0.02 0.49 9.8
Items, falling blocks, and TNT 0.04 16 0.02 2.00 40.0
Minecarts 0.04 16 0.05 0.76 16.0
Boats 0.04 16 0.00
Thrown eggs, snowballs, potions, and ender pearls 0.03 12 0.01 3.00 60.0
Experience orbs 0.03 12 0.02 1.50 30.0
Thrown fishing bobbers 0.03 12 0.08 0.375 7.5
Llama spit 0.06 24 0.01 6.00 120.0
Fired arrows, and thrown tridents 0.05 20 0.01 5.00 100.0
Fireballs, Wither skulls, and dragon fireballs [note 1][note 2] 0.10 40 0.05[note 3] 1.90 38.0

Starting at upwards velocity x, upwards velocity at tick t can be given by the formulas:

Drag before acceleration: V(t) = ((1-drag)x)-(acceleration((1-(1-drag)^t)/drag))
Drag after acceleration[note 1]: V(t) = ((1-drag)x)-(acceleration(1-drag)((1-(1-drag)^t)/drag))
  1. a b c d Note that when living entities and explosive projectiles are simulated, the drag is applied after the acceleration, rather than before; this is why their terminal velocities aren't whole numbers while the others are.
  2. Explosive projectiles are not affected by gravity but instead get acceleration from getting damaged.
  3. Dangerous wither skulls have drag force of 0.27.

Data values[edit]

Main article: Chunk format

Entity format

Main article: Chunk format/Entity
[edit]

Video[edit]

History[edit]

Java Edition
1.1?Players cannot interact with entities from far away in Creative mode.
1.4.212w34aEntities can now use portals.
1.915w31aProjectile motion has now been changed slightly.[1]
15w36aMost entities (exceptions being items and experience orbs) can now be pushed by other entities.
15w45aEntities bunched up in a 1×1 hole together no longer push away entities touching adjacent corners.
15w49aProjectiles now take the thrower's momentum into account when the player is falling, flying with elytra, or taking knockback; but not when the player is walking, riding an entity, or flying in Creative mode.
1.1116w32aEntity IDs have now been changed to have underscores and no capital letters. They can also be used by typing minecraft: before the IDs, similar to block IDs.
The ID for humans (Monster), Rana, Steve, Black Steve, and Beast Boy (Mob) have now been removed.
Pocket Edition Alpha
?The insides of mobs no longer render.
Bedrock Edition
?The insides of mobs now render again.

Issues[edit]

Issues relating to "Entity" are maintained on the bug tracker. Report issues there.

See also[edit]

  • Block entity – unlike the entities mentioned above, these are simply blocks that store additional pieces of data.

References[edit]

Entities