Entities are things in the Minecraft world which are not blocks or other objects which fit in the cubical grid. Everything which can move around freely is an entity.
Minecraft also has tile entities[1], which are blocks which have extra information beyond the 4-bit data field described in the data values article, such as signs and chests. Tile entities are unrelated to the entities discussed on this page.
General behavior
Most entities have these properties:
- A position, velocity, and rotation (as according to ordinary Newtonian physics).
- A specific volume they occupy, which is a 3-dimensional box with a fixed height and width (square when viewed from the top, and not rotating).
- Current health.
- Whether they are on fire. Fire reduces health gradually and displays flames covering the entity.
Entities can be pushed around by water currents.
Entities cannot pass through solid blocks. Most types of entities prevent blocks from being placed in the space they occupy, except for resources (dropped items) which are automatically pushed out of the block to open air. Also, if an entity does overlap a block, such as due to falling sand or a door being swung, 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 will turn black (since solid blocks always have a light level of 0), and arrows are sometimes seen to turn black (especially if fired shallowly into the ceiling).
Types of entities
The following types of entity currently exist in Minecraft.
| Kind | Solid | Drops when killed/destroyed |
Despawns | Health | Width × Height | Notes | |
|---|---|---|---|---|---|---|---|
| Players | Yes | Their inventory | No | 20 |
0.6×1.8 | ||
| Mobs | Yes | Varies | see Spawn | Varies | Varies | ||
| Boats | Yes | 2 Sticks, 3 Planks | No | 6 |
1.5×0.6 | Recovers health quickly over time. Takes damage from colliding with blocks or other entities at high speed. | |
| Minecarts | Yes (except to other entities) | 1 Minecart | No | 6 |
0.98×0.7 | Recovers health quickly over time. Snaps to rails if in a block occupied by them. | |
| Resources (dropped items) | Only to boats and minecarts | n/a | 5 minutes | 0 |
0.25×0.25 | Destroyed by explosions/fire/lava/cacti, but cannot be struck. | |
| Experience Orb | No | n/a | 5 minutes | 1 |
? | Same behaviors as dropped items; also attracted to the player. | |
| Projectile arrows | Yes (to boats in water) | n/a | 1 minute | ∞ | 0.5×0.5 | Damages other entities if moving; harmless when stuck in a block. | |
| Projectile snowballs, chicken eggs | Breaks on impact | n/a | n/a | ∞ | 0.25×0.25 | Eggs may spawn a chicken on impact. | |
| Projectile Ender Pearl | Breaks on impact | n/a | n/a | ∞ | 0.25×0.25 | Teleports player on impact. | |
| Thrown Eye of Ender | No | n/a | n/a | ∞ | 0.25×0.25 | Floats towards the closest stronghold. | |
| Primed TNT | No | n/a | 4 seconds or less (Explodes) |
∞ | 0.98×0.98 | ||
| Falling sand/gravel/Dragon egg | No | n/a | Once entity hits ground | ∞ | 0.98×0.98 | Drops sand/gravel when falling on a non-solid block such as a torch. | |
| Fishing Rod bobber | Only to boats and minecarts | n/a | 1 minute | ∞ | ? | ||
| Lightning bolt | No | n/a | Half a second | ∞ | ? | ||
| Paintings | No | Painting | n/a | ∞ | Varies | ||
| Ghast and Blaze Fireballs | Explodes on impact/deflected on hit | n/a | 1 minute | ∞ | 1.0×1.0 (Ghast), 0.3125×0.3125 (Blaze) | Only Ghast Fireballs can be deflected, Blaze Fireballs cannot | |
| Ender Crystal | Yes | 1 Bedrock (placed) | n/a | 1 |
Explodes when destroyed | 200 |
Entities listed as “solid” obstruct the passage of other entities.
The size is in block lengths (usually considered to be 1 meter), 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 as the object rotates visually.
For a listing of numeric entity IDs, see Data values.
Further notes
Reverse engineering of the Minecraft network protocol suggests that paintings are entities, but they are unusual in that they are aligned to the block grid and completely immobile. Doors, portals and beds, the other objects larger than a single block, are actually groups of adjacent blocks. it is possible to obtain a spawner egg though inventory editing with a painting's ID, however, since spawn eggs spawn the entity right above the block you told it to, it will crash minecraft with a strange crash screen.
Arrows, TNT, sand, and gravel are assumed to have infinite health because they are not destroyed by multiple TNT explosions (they can be fired out of cannons), nor by being on fire for long periods.
Boats and Minecarts
- See also: Transportation (contains information about speeds)
Boats and minecarts appear to recover health over time. For example, they can be broken by two arrows but only in quick succession, and minecarts never break as a result of being on fire (though they will break if they remain in contact with lava). (Boats are quickly destroyed by fire.) The amount of wobbling displayed by boats and minecarts when struck appears to indicate their current health.
Sand and gravel
The following description refers to sand for brevity, but gravel behaves in exactly the same way.
Sand normally exists as a block. When a sand block's support is removed, it turns into a sand entity and falls down until it hits another object, at which point it places itself as a block in the nearest on-grid position, or turns into a sand resource if that position is occupied (such as by a torch). While sand ordinarily falls straight down, it can be redirected while falling by explosions.
If there is a boat or minecart in the way of falling sand, it will place itself as a block above the vehicle, but then immediately fall down again, producing a 'hopping' effect. This can be used in the construction of a sand cannon. (Patched in Beta 1.6 and no longer works)
If when the world is created, a cave is generated underneath sand, Minecraft will fail to update the block and the sand will remain floating until a block is removed from under, above, or beside it. This latter fact means that a single falling sand block can trigger the collapse of an entire region of sand; therefore, sand ceilings should not be disturbed unless one is outside the area, standing over a torch, or prepared to dig out quickly once the sand has fallen.
Right-clicking
Entities with right-click actions (boats, minecarts, and wolves), unlike blocks with right-click actions (such as chests), do not stop the right-click action of a tool you are holding. For example, if you right-click on a tamed wolf with a bow in your hand, the wolf will sit, but you will also fire an arrow at the wolf.
Feeding food items to a wolf does not stop your eating action, despite the appearance otherwise. When tested by hacking a stack of 2 raw porkchop, and feeding them to the wolf, the wolf ate one and the player ate the other (edit: food is now stackable, but you would need to hold down the right mouse button to eat the food yourself). When using just a stack of one, the wolf gets the food before the player can, and the eating is canceled without a food item in that slot.
Riding
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. The currently possible combinations are:
- A mob or player in a minecart or boat.
- A player on a saddled pig.
- A skeleton on a spider (Spider Jockey).
- An arrow lodged in a mob.
It is possible to have multiple levels, such as a player on a pig in a minecart. Technically, it is possible to ride any entity (using mods), such as a creeper or an arrow.
Bugs
- In Creative mode (Minecraft 1.8 and later), the player can interact entities (attack or 'right-click' action) from far away — even if there are blocks in the way. This can be very annoying. For example, when you try to break a stone block, and there is a painting on the other side of the block, the stone will not break, but the painting will. Also, when you try to place a block on a wall, and there is a minecart behind that wall, you will enter the minecart, as if you had clicked it directly, instead of placing the block.