Skip to content

Entities

Entities are non-block creatures that don't align to the block grid.

Base Entity

All entities have the following properties, though usually more. These are just the most important ones. In brackets you can find their respective default values.

FieldTypeDescription
Entity IDIntegerThe ID of the entity (0)
XDoubleThe X position of the entity
YDoubleThe Y position of the entity
Y-OffsetFloatThe height of the entities bounding box (0.0)
ZDoubleThe Z position of the entity
YawFloatAbsolute rotation on the X Axis, in degrees
PitchFloatAbsolute rotation on the Y Axis, in degrees
On GroundBooleanfalse for walking/swimming, true for jumping/falling (false)
WidthFloatThe width of the entities bounding box (0.6)
HeightFloatThe height of the entities bounding box (1.8)
AirIntegerThe amount of air the entity has (300)
Max AirIntegerThe maximum amount of air the entity can have (300)
FireIntegerHow many ticks the entity will continue to burn (0)

NOTE

Some entries are left out for the sake of brevity, such as the previous position and rotation values or their chunk coordinates.

Position

The (X,Y,Z) coordinate defines where its lowest, center-most point is. For the player, this is on the ground between their feet.

Y-Offset/Stance

The Y-Offset, also called "stance" on wiki.vg, defines the eye-height of the entity. It is relative to the Y-Position.

EntityY-Offset
Default0.0
Player1.62

Width and Height

The width and height define the size of the bounding box that Minecraft uses for its collision.

EntityWidthHeight
Default0.61.8

MISSING

TODO: Other bounding box sizes

Living Entities

Living entities are a subset of entities that have more properties.

FieldTypeDescription
HealthIntegerThe health of the entity (10)
Move SpeedFloatThe movement speed of the entity (0.7)
AgeThe age of the entity (0)

NOTE

Most mobs overwrite the health value to be 20

Health

EntityHealth
Default10
Player20
Mobs20
Wolf8

Move Speed

EntityMove Speed
Default0.7
Player0.6
Spider0.8
Wolf1.1
Zombie0.5
Zombie Pigman0.5

MISSING

TODO: attackStrength of most mobs is still missing