Chunks store the terrain and entities within a 16×256×16 area. They also store precomputed lighting, heightmap data for Minecraft's performance, and other meta information.
NBT structure
Chunks are stored in NBT format, with this structure (see Block Format below for the ordering of the blocks within each array):
- The root tag.
- DataVersion: Version of the chunk NBT structure.
- Level: Chunk data.
- xPos: X position of the chunk.
- zPos: Z position of the chunk.
- LastUpdate: Tick when the chunk was last saved.
- LightPopulated: 1 or 0 (true/false) - If true, the server/client has already calculated lighting values for this chunk after generation.
- TerrainPopulated: 1 or not present (true/false) indicate whether the terrain in this chunk was populated with special things. (Ores, special blocks, trees, dungeons, flowers, waterfalls, etc.) If set to zero then Minecraft will regenerate these features in the blocks that already exist.
- V: Currently always saved as 1 and not actually loaded by the game. Likely a chunk version tag.
- InhabitedTime: The cumulative number of ticks players have been in this chunk. Note that this value increases faster when more players are in the chunk. Used for regional difficulty: increases the chances of mobs spawning with equipment, the chances of that equipment having enchantments, the chances of spiders having potion effects, the chances of mobs having the ability to pick up dropped items, and the chances of zombies having the ability to spawn other zombies when attacked. Note that at values 3600000 and above, regional difficulty is effectively maxed for this chunk. At values 0 and below, the difficulty is capped to a minimum (thus, if this is set to a negative number, it will behave identically to being set to 0, apart from taking time to build back up to the positives). See Regional Difficulty for more specifics.
- Biomes: May not exist. 256 bytes of biome data, one byte for each vertical column in the chunk. See Data Values for biome IDs. If this tag does not exist it will be created and filled by Minecraft when the chunk is loaded and saved. If any values in this array are -1, Minecraft will also set them to the correct biome.
- HeightMap: 1024 bytes(256 TAG_Int) of heightmap data. 16 × 16. Each byte records the lowest level in each column where the light from the sky is at full strength. Speeds computing of the SkyLight.
- Sections: List of Compound tags, each tag is a sub-chunk of sorts.
- An individual Section.
- Y: The Y index (not coordinate) of this section. Range 0 to 15 (bottom to top), with no duplicates but some sections may be missing if empty.
- Blocks: 4096 bytes of block IDs defining the terrain. 8 bits per block, plus the bits from the below Add tag.
- Add: May not exist. 2048 bytes of additional block ID data. The value to add to (combine with) the above block ID to form the true block ID in the range 0 to 4095. 4 bits per block. Combining is done by shifting this value to the left 8 bits and then adding it to the block ID from above.
- Data: 2048 bytes of block data additionally defining parts of the terrain. 4 bits per block.
- BlockLight: 2048 bytes recording the amount of block-emitted light in each block. Makes load times faster compared to recomputing at load time. 4 bits per block.
- SkyLight: 2048 bytes recording the amount of sunlight or moonlight hitting each block. 4 bits per block.
- An individual Section.
- Entities: Each TAG_Compound in this list defines an entity in the chunk. See Entity Format below. If this list is empty it will be a list of End tags (before 1.10, list of Byte tags).
- TileEntities: Each TAG_Compound in this list defines a block entity in the chunk. See Block Entity Format below. If this list is empty it will be a list of End tags (before 1.10, list of Byte tags).
- TileTicks: May not exist. Each TAG_Compound in this list is an "active" block in this chunk waiting to be updated. These are used to save the state of redstone machines, falling sand or water, and other activity. See Tile Tick Format below. This tag may not exist.
Block format
In the Anvil format, block positions are ordered YZX for compression purposes.
The coordinate system is as follows:
- X increases East, decreases West
- Y increases upwards, decreases downwards
- Z increases South, decreases North
This also happens to yield the most natural scan direction, because all indices in the least significant dimension (i.e. X in this case) appear for each index in the next most significant dimension; so one reads an array ordered YZX as one would a book lying with its top northward, all letters (or X-indices) on a single line (or Z-index) at a time, and all lines on a single page (or Y-index) at a time. For the 2D arrays (i.e. "Biomes" and "HeightMap") the inapplicable Y dimension is simply omitted, as though the book is only one page thick.
Each section in a chunk is a 16x16x16-block area, with up to 16 sections in a chunk. Section 0 is the bottom section of the chunk, and section 15 is the top section of the chunk. To save space, completely empty sections are not saved. Within each section is a byte tag "Y" for the Y index of the section, 0 to 15, and then byte arrays for the blocks. The "Block" byte array has 4096 partial block IDs at 8 bits per block. Another byte array "Add" is used for block with IDs over 255, and is 2048 bytes of the other part of the 4096 block IDs at 4 bits per block. When both the "Block" and "Add" byte arrays exist, the partial ID from the "Add" array is shifted left 8 bits and added to the partial ID from the "Blocks" array to form the true Block ID. The "Data" byte array is also 2048 bytes for 4096 block data values at 4 bits per block. The "BlockLight" and "SkyLight" byte arrays are the same as the "Data" byte array but they are used for block light levels and sky light levels respectively. The "SkyLight" values represent how much sunlight or moonlight can potentially reach the block, independent of the current light level of the sky.
The endianness of the 2048-byte arrays (i.e. "Add," "Data," "BlockLight," & "SkyLight"), which give only 4 bits per block, seems to stand as the one anomalous exception to the otherwise consistent, format-wide standard of big-endian data storage. It also runs counter to the presumably natural human-readable printing direction. If the blocks begin at 0, they are grouped with even numbers preceding odd numbers (i.e. 0 & 1 share a byte, 2 & 3 share the next, etc.); under these designations Minecraft stores even-numbered blocks in the least significant half-byte, and odd-numbered blocks in the most significant half-byte. Thus block[0] is byte[0] at 0x0F, block[1] is byte[0] at 0xF0, block[2] is byte[1] at 0x0F, block[3] is byte[1] at 0xF0, etc. ...
The pseudo-code below shows how to access individual block information from a single section. Hover over text to see additional information or comments.
byte Nibble4(byte[] arr, int index){ return index%2 == 0 ? arr[index/2]&0x0F : (arr[index/2]>>4)&0x0F; } int BlockPos = y*16*16 + z*16 + x; byte BlockID_a = Blocks[BlockPos]; byte BlockID_b = Nibble4(Add, BlockPos); short BlockID = BlockID_a + (BlockID_b << 8); byte BlockData = Nibble4(Data, BlockPos); byte Blocklight = Nibble4(BlockLight, BlockPos); byte Skylight = Nibble4(SkyLight, BlockPos);
Entity format
Every entity is an unnamed TAG_Compound contained in the Entities list of a chunk file. The sole exception is the Player entity, stored in level.dat, or in <player>.dat files on servers. All entities share this base:
id Pos Motion Rotation FallDistance Fire Air OnGround Dimension Invulnerable PortalCooldown UUIDMost UUIDLeast UUID CustomName CustomNameVisible Silent Riding CommandStats SuccessCountObjective SuccessCountName AffectedBlocksObjective AffectedBlocksName AffectedEntitiesObjective AffectedEntitiesName AffectedItemsObjective AffectedItemsName QueryResultObjective QueryResultName
- Entity data
- Air: How much air the entity has, in ticks. Decreases by 1 per tick when unable to breathe (except suffocating in a block). Increase by 1 per tick when it can breathe. If -20 while still unable to breathe, the entity loses 1 health and its air is reset to 0. Most mobs can have a maximum of 300 in air, while dolphins can reach up to 4800, and axolotls have 6000.
- CustomName: The custom name JSON text component of this entity. Appears in player death messages and villager trading interfaces, as well as above the entity when the player's cursor is over it. May be empty or not exist. Cannot be removed using the
data remove
command,[1] but setting it to an empty string has the same effect. - CustomNameVisible: 1 or 0 (true/false) - if true, and this entity has a custom name, the name always appears above the entity, regardless of where the cursor points. If the entity does not have a custom name, a default name is shown. May not exist.
- FallDistance: Distance the entity has fallen. Larger values cause more damage when the entity lands.
- Fire: Number of ticks until the fire is put out. Negative values reflect how long the entity can stand in fire before burning. Default -20 when not on fire.
- Glowing: 1 or 0 (true/false) - true if the entity has a glowing outline.
- HasVisualFire: 1 or 0 (true/false) - if true, the entity visually appears on fire, even if it is not actually on fire.
- id: String representation of the entity's ID. Does not exist for the Player entity.
- Invulnerable: 1 or 0 (true/false) - true if the entity should not take damage. This applies to living and nonliving entities alike: mobs should not take damage from any source (including potion effects), and cannot be moved by fishing rods, attacks, explosions, or projectiles, and objects such as vehicles and item frames cannot be destroyed unless their supports are removed. Invulnerable player entities are also ignored by any hostile mobs. Note that these entities can be damaged by players in Creative mode.
- Motion: 3 TAG_Doubles describing the current dX, dY and dZ velocity of the entity in meters per tick.
- NoGravity: 1 or 0 (true/false) - if true, the entity does not fall down naturally. Set to true by striders in lava.
- OnGround: 1 or 0 (true/false) - true if the entity is touching the ground.
- Passengers: The data of the entity(s) that is riding this entity. Note that both entities control movement and the topmost entity controls spawning conditions when created by a mob spawner.
- : The same as this format (recursive).
- Tags common to all entities
- Tags unique to this passenger entity.
- : The same as this format (recursive).
- PortalCooldown: The number of ticks before which the entity may be teleported back through a nether portal. Initially starts at 300 ticks (15 seconds) after teleportation and counts down to 0.
- Pos: 3 TAG_Doubles describing the current X, Y and Z position of the entity.
- Rotation: Two TAG_Floats representing rotation in degrees.
- The entity's rotation around the Y axis (called yaw). Values vary from -180 (facing due north) to -90 (facing due east) to 0 (facing due south) to +90 (facing due west) to +180 (facing due north again).[2]
- The entity's declination from the horizon (called pitch). Horizontal is 0. Positive values look downward. Does not exceed positive or negative 90 degrees.
- Silent: 1 or 0 (true/false) - if true, this entity is silenced. May not exist.
- Tags: List of scoreboard tags of this entity.
- TicksFrozen: Optional. How many ticks the entity has been freezing. Although this tag is defined for all entities, it is actually only used by mobs that are not in the freeze_immune_entity_types entity type tag. Ticks up by 1 every tick while in powder snow, up to a maximum of 300 (15 seconds), and ticks down by 2 while out of it.
- UUID: This entity's Universally Unique IDentifier. The 128-bit UUID is stored as four 32-bit integers, ordered from most to least significant.
Mobs
Mob Entities | |
---|---|
Entity ID | Name |
Bat | Bat |
Blaze | Blaze |
CaveSpider | Cave Spider |
Chicken[note 1] | Chicken |
Cow[note 1] | Cow |
Creeper | Creeper |
EnderDragon | Ender Dragon |
Enderman | Enderman |
Endermite | Endermite |
Ghast | Ghast |
Giant | Giant |
Guardian | Guardian Elder Guardian |
EntityHorse[note 1] | Horse |
LavaSlime | Magma Cube |
MushroomCow[note 1] | Mooshroom |
Ozelot[note 1][note 2] | Ocelot |
Pig[note 1] | Pig |
PigZombie | Zombie Pigman |
PolarBear | Polar Bear |
Rabbit[note 1] | Rabbit |
Sheep[note 1] | Sheep |
Shulker | Shulker |
Silverfish | Silverfish |
Skeleton | Skeleton Wither Skeleton Stray |
Slime | Slime |
SnowMan | Snow Golem |
Spider | Spider |
Squid | Squid |
Villager[note 1] | Villager |
VillagerGolem | Iron Golem |
Witch | Witch |
WitherBoss | Wither |
Wolf[note 1][note 2] | Wolf |
Zombie | Zombie Zombie Villager Husk |
Mobs are a subclass of Entity with additional tags to store their health, attacking/damaged state, potion effects, and more depending on the mob. Players are a subclass of Mob.
- Entity data
- Tags common to all entities
- Tags common to all mobs
- BatFlags: 1 or 0 (true/false) - true if the bat is hanging upside-down from a block, false if the bat is flying.
- Entity data
- Tags common to all entities
- Tags common to all mobs
- Entity data
- Tags common to all entities
- Tags common to all mobs
- Entity data
- Additional fields for mobs that can breed
- Tags common to all entities
- Tags common to all mobs
- EggLayTime: Number of ticks until the chicken lays its egg. Laying occurs at 0 and this timer gets reset to a new random value between 6000 and 12000.
- IsChickenJockey: 1 or 0 (true/false) - Whether or not the chicken is a jockey for a baby zombie. If true, the chicken can naturally despawn, drops 10 experience upon death instead of 1-3 and cannot lay eggs. Baby zombies can still control a ridden chicken even if this is set false.
- Entity data
- Additional fields for mobs that can breed
- Tags common to all entities
- Tags common to all mobs
- Entity data
- Tags common to all entities
- Tags common to all mobs
- ExplosionRadius: The radius of the explosion itself, default 3.
- Fuse: States the initial value of the creeper's internal fuse timer (does not affect creepers that fall and explode upon impacting their victim). The internal fuse timer returns to this value if the creeper is no longer within attack range. Default 30.
- ignited: 1 or 0 (true/false) - Whether the creeper has been ignited by flint and steel.
- powered: 1 or 0 (true/false) - May not exist. True if the creeper is charged from being struck by lightning.
- Entity data
- Tags common to all entities
- Tags common to all mobs
- DragonPhase: A number indicating the dragon's current state. Valid values are: 0=circling, 1=strafing (preparing to shoot a fireball), 2=flying to the portal to land (part of transition to landed state), 3=landing on the portal (part of transition to landed state), 4=taking off from the portal (part of transition out of landed state), 5=landed, performing breath attack, 6=landed, looking for a player for breath attack, 7=landed, roar before beginning breath attack, 8=charging player, 9=flying to portal to die, 10=hovering with no AI (default when using the
/summon
command).
- Entity data
- Additional fields for mobs that can become angry
- Tags common to all entities
- Tags common to all mobs
- carriedBlockState: Optional. The block carried by the enderman.
- Name: The resource location of the block.
- Properties: Optional. The block states of the block.
- Name: The block state name and its value.
- Entity data
- Tags common to all entities
- Tags common to all mobs
- Lifetime: How long the endermite has existed in ticks. Disappears when this reaches around 2400.
- Entity data
- Tags common to all entities
- Tags common to all mobs
- Tags common to all mobs spawnable in raids
- SpellTicks: Number of ticks until a spell can be cast. Set to a positive value when a spell is cast, and decreases by 1 per tick.
- Entity data
- Additional fields for mobs that can breed
- Tags common to all entities
- Tags common to all mobs
- Tags common to all horses
- ArmorItem: The armor of this horse. Ignored if the item is not one of the horse armors.
- Tags common to all items
- Variant: The variant of the horse. Determines colors. Stored as
baseColor | (markings << 8)
. Unused values lead to white horses.
- Entity data
- Tags common to all entities
- Tags common to all mobs
- ExplosionPower: The radius of the explosion created by the fireballs the ghast fires. Default value is 1.
- Entity data
- Tags common to all entities
- Tags common to all mobs
- Entity data
- Tags common to all entities
- Tags common to all mobs
- Entity data
- Additional fields for mobs that can breed
- Tags common to all entities
- Tags common to all mobs
- Bred: 1 or 0 (true/false) - Unknown. Remains 0 after breeding. If true, causes it to stay near other llamas with this flag set.
- ChestedHorse: 1 or 0 (true/false) - true if the llama has chests.
- DecorItem: The item the llama is wearing, without the Slot tag. Typically a carpet.
- Tags common to all items
- DespawnDelay: A timer for trader llamas to despawn, present only in
trader_llama
. The trader llama despawns when this value reaches 0. - EatingHaystack: 1 or 0 (true/false) - true if grazing.
- Items: List of items. Exists only if
ChestedHorse
is true.- An item, including the Slot tag.
- Tags common to all items
- An item, including the Slot tag.
- Owner: The UUID of the player that tamed the llama, stored as four ints. Has no effect on behavior. Does not exist if there is no owner.
- Variant: The variant of the llama. 0 = Creamy, 1 = White, 2 = Brown, 3 = Gray.
- Strength: Ranges from 1 to 5, defaults to 3. Determines the number of items the llama can carry (items = 3 × strength). Also increases the tendency of wolves to run away when attacked by llama spit. Strengths 4 and 5 always causes a wolf to flee.
- Tame: 1 or 0 (true/false) - true if the llama is tamed.
- Temper: Ranges from 0 to 100; increases with feeding. Higher values make a llama easier to tame.
- Entity data
- Tags common to all entities
- Tags common to all mobs
- Size: The size of the magma cube. Note that this value is zero-based, so 0 is the smallest magma cube, 1 is the next larger, etc. The sizes that spawn naturally are 0, 1, and 3.
- wasOnGround: 1 or 0 (true/false) - true if the magma cube is touching the ground.
- Entity data
- Additional fields for mobs that can breed
- Tags common to all entities
- Tags common to all mobs
- EffectDuration: Optional. An integer indicating the duration of the status effect the brown mooshroom may give to a suspicious stew.
- EffectId: Optional. A byte indicating the type of the status effect the brown mooshroom may give to a suspicious stew.
- Type: ID of the mooshroom's type.
Mooshroom type
- Entity data
- Additional fields for mobs that can breed
- Tags common to all entities
- Tags common to all mobs
- Trusting: 1 or 0 (true/false) - true if the ocelot trusts players.
- Entity data
- Additional fields for mobs that can breed
- Tags common to all entities
- Tags common to all mobs
- Saddle: 1 or 0 (true/false) - true if there is a saddle on the pig.
- Entity data
- Additional fields for mobs that can become angry
- Tags common to all entities
- Tags common to all mobs
- Tags common to all zombies
- Entity data
- Additional fields for mobs that can become angry
- Additional fields for mobs that can breed
- Tags common to all entities
- Tags common to all mobs
- Entity data
- Additional fields for mobs that can breed
- Tags common to all entities
- Tags common to all mobs
- MoreCarrotTicks: Set to 40 when a carrot crop is eaten, decreases by 0–2 every tick until it reaches 0. Has no effect in game.
- RabbitType: Determines the skin of the rabbit. Also determines if rabbit should be hostile.
- Entity data
- Tags common to all entities
- Tags common to all mobs
- APX: Approximate X coordinate.
- APY: Approximate Y coordinate.
- APZ: Approximate Z coordinate.
- AttachFace: Direction of the block the shulker is attached to. Below is
0b
, above is1b
, north is2b
, south is3b
, west is4b
, east is5b
. - Color: The color of the shulker. Default is 0. Shulkers spawned by eggs or as part of End cities have value 16.
- Peek: Height of the head of the shulker.
Shulker color
- Entity data
- Tags common to all entities
- Tags common to all mobs
- Entity data
- Tags common to all entities
- Tags common to all mobs
- StrayConversionTime: The number of ticks until this skeleton converts to a stray (default value is -1, when no conversion is under way).
- Entity data
- Tags common to all entities
- Tags common to all mobs
- Size: The size of the slime. Note that this value is zero-based, so 0 is the smallest slime, 1 is the next larger, etc. The sizes that spawn naturally are 0, 1, and 3. Values that are greater than 126 get clamped to 126.
- wasOnGround: 1 or 0 (true/false) - true if the slime is touching the ground.
- Entity data
- Tags common to all entities
- Tags common to all mobs
- Pumpkin : 1 or 0 (true/false) - whether or not the Snow Golem has a pumpkin on its head.
- Entity data
- Tags common to all entities
- Tags common to all mobs
- Entity data
- Tags common to all entities
- Tags common to all mobs
- Entity data
- Tags common to all entities
- Tags common to all mobs
- BoundX: When a vex is idle, it wanders, selecting air blocks from within a 15×11×15 cuboid range centered at X,Y,Z =
BoundX
,BoundY
,BoundZ
. This central spot is the location of the evoker when it summoned the vex, or if an evoker was not involved,BoundX
,BoundY
andBoundZ
do not exist. - BoundY: See
BoundX
. - BoundZ: See
BoundX
. - LifeTicks: Ticks of life remaining, decreasing by 1 per tick. When it reaches zero, the vex starts taking damage and
LifeTicks
is set to 20.
- Entity data
- Additional fields for mobs that can breed
- Tags common to all entities
- Tags common to all mobs
- Tags common to all villagers
- Inventory: Each compound tag in this list is an item in the villager's inventory, up to a maximum of 8 slots. Items in two or more slots that can be stacked together are automatically condensed into one slot. If there are more than 8 slots, the last slot is removed until the total is 8. If there are 9 slots but two previous slots can be condensed, the last slot returns after the two other slots are combined.
- An item in the inventory, excluding the Slot tag.
- Tags common to all items
- An item in the inventory, excluding the Slot tag.
- LastRestock: The last tick the villager went to their job site block to resupply their trades.
- LastGossipDecay: The last tick all gossip of the villager has decreased strength naturally.
- RestocksToday: The number of restocks a villager has done in 10 minutes from the last restock, or
0
if the villager has not restocked in the last 10 minutes. When a villager has restocked twice in less than 10 minutes, it waits at least 10 minutes for another restock. - Willing: 1 or 0 (true/false) – true if the villager is willing to mate. Becomes true after certain trades (those that would cause offers to be refreshed), and false after mating.
Villager type
Villager profession
- Entity data
- Tags common to all entities
- Tags common to all mobs
- Tags common to all mobs spawnable in raids
- Johnny: 1 or 0 (true/false) - if true, causes the vindicator to exhibit Johnny behavior. Setting to false prevents the vindicator exhibiting Johnny behavior, even if named Johnny. Optional.
- Entity data
- Additional fields for mobs that can become angry
- Tags common to all entities
- Tags common to all mobs
- PlayerCreated: 1 or 0 (true/false) - if true, this golem is player-created and never attacks players.
- Entity data
- Tags common to all entities
- Tags common to all mobs
- Tags common to all mobs spawnable in raids
- Entity data
- Tags common to all entities
- Tags common to all mobs
- Invul: The number of ticks of invulnerability left after being initially created. 0 once invulnerability has expired.
- Entity data
- Additional fields for mobs that can become angry
- Additional fields for mobs that can be tamed by players
- Additional fields for mobs that can breed
- Tags common to all entities
- Tags common to all mobs
- CollarColor: The color of the wolf's collar. Present even for wild wolves (but does not render); default value is 14.
- Entity data
- Tags common to all entities
- Tags common to all mobs
- Tags common to all zombies
Projectiles
Projectile Entities | |
---|---|
Entity ID | Name |
Arrow | Arrow |
DragonFireball | Ender Dragon Fireball |
Fireball | Ghast Fireball |
SmallFireball | Blaze Fireball/Fire Charge |
Snowball | Snowball |
SpectralArrow | Spectral Arrow |
ThrownEgg | Egg |
ThrownEnderpearl | Ender Pearl |
ThrownExpBottle | Bottle o' Enchanting |
ThrownPotion | Splash Potion |
WitherSkull | Wither Skull |
Projectiles are a subclass of Entity and have very obscure tags such as X,Y,Z coordinate tags despite Entity Pos tag, inTile despite inGround, and shake despite most projectiles not being arrows. While all projectiles share tags, they are all independently implemented through Throwable
, ArrowBase
, and FireballBase
.
- Entity data
- Tags common to all arrows
- Tags common to all entities
- Tags common to all projectiles
- Note: An arrow entity is a tipped arrow if it has either the
Potion
orCustomPotionEffects
tag. - Tags common to all potion effects
- Color: Used by the arrow entity, for displaying the custom potion color of a fired arrow item that had a
CustomPotionColor
tag. The numeric color code are calculated from the Red, Green and Blue components using this formula: Red<<16 + Green<<8 + Blue. For positive values larger than 0x00FFFFFF, the top byte is ignored. All negative values remove the particles.
- Entity data
- Tags common to all entities
- Tags common to all fireballs
- Tags common to all projectiles
Ghast/ED1
Fire Charge/ED
- Entity data
- Tags common to all entities
- Tags common to all projectiles
- Item: The item to render as, may be absent.
- Tags common to all items
- Entity data
- Tags common to all arrows
- Tags common to all entities
- Tags common to all projectiles
- Duration: The time in ticks that the Glowing effect persists.
- Entity data
- Tags common to all entities
- Tags common to all projectiles
- Item: The item to render as, may be absent.
- Tags common to all items
- Entity data
- Tags common to all entities
- Tags common to all projectiles
- Item: The item to render as, may be absent.
- Tags common to all items
- Entity data
- Tags common to all entities
- Tags common to all projectiles
- Item: The item to render as, may be absent.
- Tags common to all items
- Entity data
- Tags common to all entities
- Tags common to all projectiles
- Item: The item that was thrown. The entity renders as a lingering potion if the id is
lingering_potion
, otherwise it renders as a splash potion.- Tags common to all potion items
- Entity data
- Tags common to all entities
- Tags common to all fireballs
- Tags common to all projectiles
Items and XPOrbs
Item Entities | |
---|---|
Entity ID | Name |
Item | Dropped Item |
XPOrb | Experience Orb |
Items and XPOrbs are a subclass of Entity.
- Entity data
- Tags common to all entities
- Age: The number of ticks the item has been "untouched". After 6000 ticks (5 minutes) the item is destroyed. If set to -32768, the Age does not increase, preventing the item from despawning automatically.
- Health: The health of the item, which starts at 5. Items take damage from fire, lava, cacti and explosions. The item is destroyed when its health reaches 0.
- Item: The inventory item, without the Slot tag.
- Tags common to all items
- Owner: If present, only the player with this UUID can pick up the item. Used by the give command (and can be set in a summon command) to prevent the wrong player from picking up the spawned item entity.
- PickupDelay: The number of ticks the item cannot be picked up. Decreases by 1 per tick. If set to 32767, the PickupDelay does not decrease, preventing the item from being picked up.
- Thrower: The UUID of the player who dropped the item. Not present if the item was not dropped by a player.
- Entity data
- Tags common to all entities
- Age: The number of ticks the XP orb has been "untouched". After 6000 ticks (5 minutes) the orb is destroyed.
- Count: The remaining number of times that the orb can be picked up. When the orb is picked up, the value decreases by 1. When multiple orbs are merged, their values are added up to result orb. When the value reaches 0, the orb is depleted.
- Health: The health of XP orbs. XP orbs take damage from fire, lava, falling anvils, and explosions. The orb is destroyed when its health reaches 0.
- Value: The amount of experience the orb gives when picked up.
Vehicles
Vehicle Entities | |
---|---|
Entity ID | Name |
Boat | Boat |
Minecart Minecart with Chest Minecart with Furnace | |
MinecartRideable | Minecart |
MinecartChest | Minecart with Chest |
MinecartFurnace | Minecart with Furnace |
MinecartSpawner | Minecart with Spawner |
MinecartTNT | Minecart with TNT |
MinecartHopper | Minecart with Hopper |
MinecartCommandBlock | Minecart with Command Block |
Vehicles are subclasses of Entity.
- Entity data
- Tags common to all entities
- Tags common to all minecarts
- Entity data
- Tags common to all container entities
- Tags common to all entities
- Tags common to all minecarts
- Entity data
- Tags common to all entities
- Tags common to all minecarts
- Fuel: The number of ticks until the minecart runs out of fuel.
- PushX: Force along X axis, used for smooth acceleration/deceleration.
- PushZ: Force along Z axis, used for smooth acceleration/deceleration.
- Entity data
- Tags common to all entities
- Tags common to all minecarts
- Tags common to all spawners
- Entity data
- Tags common to all entities
- Tags common to all minecarts
- TNTFuse: Time until explosion or -1 if deactivated.
- Entity data
- Tags common to all container entities
- Tags common to all entities
- Tags common to all minecarts
- Enabled: Determines whether or not the minecart hopper picks up items into its inventory.
- TransferCooldown: Time until the next transfer in game ticks, between 1 and 8, or 0 if there is no transfer.
- Entity data
- Tags common to all entities
- Tags common to all minecarts
- Command: The command entered into the minecart.
- LastOutput: The last line of output generated by the minecart. Still stored even if the gamerule commandBlockOutput is false. Appears in the GUI of the minecart when right-clicked, and includes a timestamp of when the output was produced.
- SuccessCount: Represents the strength of the analog signal output by redstone comparators attached to this minecart. Only updated when the minecart is activated with an activator rail.
- TrackOutput: 1 or 0 (true/false) - Determines whether the LastOutput is stored. Can be toggled in the GUI by clicking a button near the "Previous Output" textbox. Caption on the button indicates current state: "O" if true,"X" if false.
Dynamic tiles
Dynamic Block Entities | |
---|---|
Entity ID | Name |
PrimedTnt | TNT |
FallingSand | Dynamic Tile |
Dynamic tiles are a subclass of Entity and are used to simulate realistically moving blocks.
TNT/BE
- Dynamic block entity data
- Tags common to all entities
- BlockState: The falling block represented by this entity.
- Name: The resource location of the block.
- Properties: Optional. The block states of the block.
- Name: The block state name and its value.
- CancelDrop: 1 or 0 (true/false). Whether the block will be cancelled from being placed when it lands on a solid block. When true, it also prevents the block from dropping as an item (regardless of what the
DropItem
tag is set to). However, if true and the falling block'sTime
tag goes to 0 before landing on a solid block, it will still destroy itself and drop itself as an item (or not, respective to what theDropItem
tag is set to).CancelDrop
defaults to false for summoned and naturally occurring falling blocks (except for Suspicious Blocks). - DropItem: 1 or 0 (true/false) – true if the block should drop as an item when it breaks. Any block that does not have an item form with the same ID as the block does not drop even if this is set.
- FallHurtAmount: Multiplied by the
FallDistance
to calculate the amount of damage to inflict. By default this value is 2 for anvils, and 6 for pointed dripstone. - FallHurtMax: The maximum hit points of damage to inflict on entities that intersect this falling block. For vanilla falling blocks, always 40 × 20.
- HurtEntities: 1 or 0 (true/false) – true if the block should hurt entities it falls on.
- TileEntityData: Optional. The tags of the block entity for this block.
- Time: The number of ticks the entity has existed. When
Time
goes above 600, or above 100 while the block is below Y=1 or is outside building height, the entity is deleted.
Other
Other Entities | |
---|---|
Entity ID | Name |
AreaEffectCloud | Area Effect Cloud |
ArmorStand | Armor Stand |
EnderCrystal | Ender Crystal |
evocation_fangs | Evocation Fangs |
EyeOfEnderSignal | Eye of Ender |
FireworksRocketEntity | Firework Rocket |
ItemFrame | Item Frame |
LeashKnot | Lead Knot |
Painting | Painting |
ShulkerBullet | Shulker Bullet |
Fishing Rod Bobber |
Other entity types that are a subclass of Entity but do not fit into any of the above categories.
- Entity data
- Tags common to all entities
- Age: Age of the field. Increases by 1 every tick. When this is bigger than
Duration
+WaitTime
the area effect cloud dissipates. - Color: The color of the displayed particle. Uses the same format as the color tag from Display Properties.
- Duration: The maximum age of the field after
WaitTime
. - DurationOnUse: The amount the duration of the field changes upon applying the effect.
- Effects: A list of the applied effects.
- An individual effect.
- Ambient: 1 or 0 (true/false) - whether or not this is an effect provided by a beacon and therefore should be less intrusive on the screen. Optional, and defaults to false. Due to a bug, it has no effect on splash potions.
- Amplifier: The amplifier of the effect, with level I having value 0. Negative levels are discussed here. Optional, and defaults to level I.
- Duration: The duration of the effect in ticks. Values 0 or lower are treated as 1. Optional, and defaults to 1 tick.
- Id: The numeric ID of the effect.
- ShowIcon: 1 or 0 (true/false) - true if effect icon is shown. false if no icon is shown.
- ShowParticles: 1 or 0 (true/false) - whether or not this effect produces particles. Optional, and defaults to true. Due to a bug, it has no effect on splash potions.
- An individual effect.
- Owner: The UUID of the entity who created the cloud, stored as four ints.
- Particle: The particle displayed by the field. This is the exact same as used in the
/particle
command, including additional parameters used for particles, for exampledust 1 0 0 1
. - Potion: The name of the default potion effect. See potion data values for valid IDs.
- Radius: The field's radius.
- RadiusOnUse: The amount the radius changes upon applying the effect. Normally negative.
- RadiusPerTick: The amount the radius changes per tick. Normally negative.
- ReapplicationDelay: The number of ticks before reapplying the effect.
- WaitTime: The time before deploying the field. The
Radius
is ignored, meaning that any specified effects is not applied and specified particles appear only at the center of the field, untilAge
hits this number.
- Entity data
- Tags common to all entities
- Tags common to mobs except LeftHanded, DeathLootTable, DeathLootTableSeed, NoAI, Leash, CanPickUpLoot and PersistenceRequired.
- Tags common to all mobs
- DisabledSlots: Bit field allowing disable place/replace/remove of armor elements. For example, the value
16191
or4144896
disables placing, removing and replacing of all equipment. These can be found using the bitwise OR operator. - Invisible: 1 or 0 (true/false) - if true, ArmorStand is invisible, although items on it still display.
- Marker: 1 or 0 (true/false) - if true, ArmorStand's size is set to 0, has a tiny hitbox, and disables interactions with it. May not exist.
- NoBasePlate: 1 or 0 (true/false) - if true, ArmorStand does not display the base beneath it.
- Pose: Rotation values for the ArmorStand's pose.
- Body: Body-specific rotations.
- : x-rotation.
- : y-rotation.
- : z-rotation.
- Head: Head-specific rotations.
- : x-rotation.
- : y-rotation.
- : z-rotation.
- LeftArm: Left Arm-specific rotations.
- : x-rotation.
- : y-rotation.
- : z-rotation.
- LeftLeg: Left Leg-specific rotations.
- : x-rotation.
- : y-rotation.
- : z-rotation.
- RightArm: Right Arm-specific rotations.
- : x-rotation.
- : y-rotation.
- : z-rotation.
- RightLeg: Right Leg-specific rotations.
- : x-rotation.
- : y-rotation.
- : z-rotation.
- Body: Body-specific rotations.
- ShowArms: 1 or 0 (true/false) - if true, ArmorStand displays full wooden arms. If false, also place and replace interactions with the hand item slot are disabled.
- Small: 1 or 0 (true/false) - if true, ArmorStand is much smaller, similar to the size of a baby zombie.
Disabled slots
Binary | Integer number | Result |
---|---|---|
2^0 | 1 | Disable adding or changing mainhand item |
2^1 | 2 | Disable adding or changing boots item |
2^2 | 4 | Disable adding or changing leggings item |
2^3 | 8 | Disable adding or changing chestplate item |
2^4 | 16 | Disable adding or changing helmet item |
2^5 | 32 | Disable adding or changing offhand item |
2^8 | 256 | Disable removing or changing mainhand item |
2^9 | 512 | Disable removing or changing boots item |
2^10 | 1024 | Disable removing or changing leggings item |
2^11 | 2048 | Disable removing or changing chestplate item |
2^12 | 4096 | Disable removing or changing helmet item |
2^13 | 8192 | Disable removing or changing offhand item |
2^16 | 65536 | Disable adding mainhand item |
2^17 | 131072 | Disable adding boots item |
2^18 | 262144 | Disable adding leggings item |
2^19 | 524288 | Disable adding chestplate item |
2^20 | 1048576 | Disable adding helmet item |
2^21 | 2097152 | Disable adding offhand item |
Ender Crystal/ED
- Entity data
- Tags common to all entities
- Owner: The UUID of the entity that that fired the fangs, stored as four ints. If the entity is an Illager, the fangs do not damage other Illagers.
- Warmup: Time in ticks until the fangs appear. The fangs appear and begin to close as soon as this value becomes zero or less; negative values simply result in no delay. The value continues ticking down while the closing animation is playing, reaching -20 on naturally spawned fangs.
- Entity data
- Tags common to all entities
- Item: The item to render as, may be absent.
- Tags common to all items
- Entity data
- Tags common to all entities
- Tags common to all projectiles
- FireworksItem: The crafted firework rocket.
- Count: The item count, typically 1.
- id: The id of the item, should be
minecraft:firework_rocket
. - tag: The tag tag.
- Fireworks: One of these may appear on a firework rocket.
- Explosions: List of compounds representing each explosion this firework causes.
- : A firework explosion.
- Tags common to all firework explosion effects
- : A firework explosion.
- Flight: Indicates the flight duration of the firework (equals the amount of gunpowder used in crafting the rocket). Can be anything from -128 to 127.
- Explosions: List of compounds representing each explosion this firework causes.
- Fireworks: One of these may appear on a firework rocket.
- Life: The number of ticks this fireworks rocket has been flying for.
- LifeTime: The number of ticks before this fireworks rocket explodes. This value is randomized when the firework is launched: ((Flight + 1) * 10 + random(0 to 5) + random(0 to 6))
- ShotAtAngle: 1 or 0 (true/false) - true if this firework was shot from a crossbow or dispenser.
- Entity data
- Tags common to all entities
- Tags common to all hangables
- Fixed: 1 or 0 (true/false) - true to prevent it from dropping if it has no support block, being moved (e.g. by pistons), taking damage (except from creative players), and placing an item in it, removing its item, or rotating it.
- Invisible: 1 or 0 (true/false) - Whether the item frame is invisible. The contained item or map remains visible.
- Item: The item, without the slot tag. If the item frame is empty, this tag does not exist.
- Tags common to all items
- ItemDropChance: The chance for the item to drop when the item frame breaks. 1.0 by default.
- ItemRotation: The number of times the item has been rotated 45 degrees clockwise.
- Entity data
- Tags common to all entities
- Entity data
- Tags common to all entities
- Tags common to all hangables
- variant: The resource location for the the painting variant.
- Entity data
- Tags common to all entities
- Tags common to all projectiles
- Steps: How many "steps" it takes to attack to the target. The higher it is, the further out of the way the bullet travels to get to the target. If set to 0, it makes no attempt to attack the target and instead uses TXD/TYD/TZD in a straight line.
- Target: The UUID of the target of this shulker bullet, stored as four ints.
- TXD: The offset in the X direction to travel in accordance with its target.
- TYD: The offset in the Y direction to travel in accordance with its target.
- TZD: The offset in the Z direction to travel in accordance with its target.
Block entity format
Block Entities | |
---|---|
Block Entity ID | Associated Block |
Airportal | End Portal (block) |
Banner | Banner |
Beacon | Beacon |
Cauldron (Computer Edition) | Brewing Stand |
Cauldron (PE) | Cauldron |
Chest | Chest Trapped Chest |
Comparator | Redstone Comparator |
Control | Command Block |
DLDetector | Daylight Sensor |
Dropper | Dropper |
EnchantTable | Enchantment Table |
EnderChest | Ender Chest |
EndGateway | End Gateway (block) |
FlowerPot | Flower Pot |
Furnace | Furnace |
Hopper | Hopper |
MobSpawner | Monster Spawner |
Music | Note Block |
Piston | Piston Moving |
RecordPlayer | Jukebox |
Sign | Sign |
Skull | Mob head |
Structure | Structure Block |
Trap | Dispenser |
A block entity (not related to entity) is used by Minecraft to store information about a block that can't be stored in the four bits of block data the block has. Block entities were called "tile entities" until the 1.8 snapshots and that term is still used in some command usage.
- Block entity data
- Tags common to all block entities
- Block entity data
- Tags common to all block entities
- CustomName: Optional. The name of this beacon in JSON text component, which appears when attempting to open it, while it is locked.
- Patterns: List of all patterns applied to the banner.
- : An individual pattern.
- Color: Color of the section.
- Pattern: The banner pattern code the color is applied to.
- : An individual pattern.
Pattern
- Block entity data
- Tags common to all block entities
- CustomName: Optional. The name of this beacon in JSON text component, which appears when attempting to open it, while it is locked.
- Lock: Optional. When not blank, prevents the container from being opened unless the opener is holding an item whose name matches this string.
- Levels: The number of levels available from the pyramid. Immediately changes to the correct value if modified using commands. Note that this is also always 0 if the beam is blocked.
- Primary: The primary effect selected, see Potion effects for IDs. Set to -1 when no effect is selected. Cannot be set to an effect which beacons do not normally use, otherwise immediately changes back to -1. Although Regeneration cannot normally be chosen as the primary effect, setting this value to 10 works and even allows Regeneration II to be chosen as the secondary via the normal beacon GUI.
- Secondary: The secondary effect selected, see Potion effects for IDs. Set to -1 when no effect is selected. Cannot be set to an effect which beacons do not normally use, otherwise immediately changes back to -1. When set without a primary effect, does nothing. When set to the same as the primary, the effect is given at level 2 (the normally available behavior for 5 effects). When set to a different value than the primary (normally only Regeneration), gives the effect at level 1.
Cauldron/BE
- Block entity data
- Tags common to all block entities
- BrewTime: The number of ticks the potions have to brew.
- CustomName: Optional. The name of this container in JSON text component, which appears in its GUI where the default name ordinarily appears.
- Fuel: Remaining fuel for the brewing stand. 20 when full, and counts down by 1 each time a potion is brewed.
- Items: List of items in this container.
- : An item in the brewing stand, including the slot tag:
Slot 0: Left potion slot.
Slot 1: Middle potion slot.
Slot 2: Right potion slot.
Slot 3: Where the potion ingredient goes.
Slot 4: Fuel (Blaze Powder).- Tags common to all items
- : An item in the brewing stand, including the slot tag:
- Lock: Optional. When not blank, prevents the container from being opened unless the opener is holding an item whose name matches this string.
- Block entity data
- Tags common to all block entities
- CustomName: Optional. The name of this container in JSON text component, which appears in its GUI where the default name ordinarily appears.
- Items: List of items in this container.
- : An item, including the slot tag. Chest slots are numbered 0-26, 0 starts in the top left corner.
- Tags common to all items
- : An item, including the slot tag. Chest slots are numbered 0-26, 0 starts in the top left corner.
- Lock: Optional. When not blank, prevents the container from being opened unless the opener is holding an item whose name matches this string.
- LootTable: Optional. Loot table to be used to fill the chest when it is next opened, or the items are otherwise interacted with.[note 1]
- LootTableSeed: Optional. Seed for generating the loot table. 0 or omitted use a random seed.[note 1]
- gold: Exists only in the april fools snapshot 23w13a_or_b. Optional. When set to anything but 0, turns the chest into a golden chest.
- Block entity data
- Tags common to all block entities
- OutputSignal: Represents the strength of the analog signal output of this redstone comparator.
- Block entity data
- Tags common to all block entities
- auto: 1 or 0 (true/false) - Allows to activate the command without the requirement of a redstone signal.
- Command: The command to issue to the server.
- conditionMet: 1 or 0 (true/false) - Indicates whether a conditional command block had its condition met when last activated. True if not a conditional command block.
- CustomName: Optional. The name JSON text component of this command block, replacing the usual '@' when using commands such as
/say
and/tell
. - LastExecution: stores the tick a chain command block was last executed in.
- LastOutput: The last line of output generated by the command block. Still stored even if the game rule
commandBlockOutput
isfalse
. Appears in the GUI of the block when right-clicked, and includes a timestamp of when the output was produced. - powered: 1 or 0 (true/false) - States whether or not the command block is powered by redstone or not.
- SuccessCount: Represents the strength of the analog signal output by redstone comparators attached to this command block.
- TrackOutput: 1 or 0 (true/false) - Determines whether the LastOutput is stored. Can be toggled in the GUI by clicking a button near the "Previous Output" textbox. Caption on the button indicates current state: "O" if true, "X" if false.
- UpdateLastExecution: 1 or 0 (true/false) - Defaults to true. If set to false, loops can be created where the same command block can run multiple times in one tick.
Daylight Sensor/BE
- Block entity data
- Tags common to all block entities
- CustomName: Optional. The name of this container in JSON text component, which appears in its GUI where the default name ordinarily appears.
- Items: List of items in this container.
- : An item, including the slot tag. Dropper slots are numbered 0-8 with 0 in the top left corner.
- Tags common to all items
- : An item, including the slot tag. Dropper slots are numbered 0-8 with 0 in the top left corner.
- Lock: Optional. When not blank, prevents the container from being opened unless the opener is holding an item whose name matches this string.
- LootTable: Optional. Loot table to be used to fill the dropper when it is next opened, or the items are otherwise interacted with.[note 1]
- LootTableSeed: Optional. Seed for generating the loot table. 0 or omitted uses a random seed.[note 1]
- Lunar: Exists only in the april fools snapshot 23w13a_or_b. Optional. When set to any full number from -128 to 127, turns it to a lunar base dropper, and placing light or heavy pressure plate on top of it will create the lunar base structure.
Enchantment Table/BE
- Block entity data
- Tags common to all block entities
- Block entity data
- Tags common to all block entities
- Age: Age of the portal, in ticks. This is used to determine when the beam is rendered.
- ExactTeleport: 1 or 0 (true/false) - Teleports entities directly to the ExitPortal coordinates instead of near them.
- ExitPortal: Location entities are teleported to when entering the portal.
- X: X coordinate of target location.
- Y: Y coordinate of target location.
- Z: Z coordinate of target location.
Flower Pot/BE
- Block entity data
- Tags common to all block entities
- BurnTime: Number of ticks left before the current fuel runs out.
- CookTime: Number of ticks the item has been smelting for. The item finishes smelting when this value reaches 200 (10 seconds). Is reset to 0 if BurnTime reaches 0.
- CookTimeTotal: Number of ticks It takes for the item to be smelted.
- CustomName: Optional. The name of this container in JSON text component, which appears in its GUI where the default name ordinarily appears.
- Items: List of items in this container.
- : An item in the furnace, including the slot tag:
Slot 0: The item(s) being smelted.
Slot 1: The item(s) to use as the next fuel source.
Slot 2: The item(s) in the result slot.- Tags common to all items
- : An item in the furnace, including the slot tag:
- Lock: Optional. When not blank, prevents the container from being opened unless the opener is holding an item whose name matches this string.
- RecipesUsed: Which recipes have been used since the last time a recipe result item was manually removed from the GUI. Used to calculate experience given to the player when taking out the resulting item.
- recipe ID: How many times this specific recipe has been used. The recipe ID is the identifier of the smelting recipe, as a resource location, as used in the
/recipe
command.
- recipe ID: How many times this specific recipe has been used. The recipe ID is the identifier of the smelting recipe, as a resource location, as used in the
- Block entity data
- Tags common to all block entities
- CustomName: Optional. The name of this container in JSON text component, which appears in its GUI where the default name ordinarily appears.
- Items: List of items in this container.
- : An item, including the slot tag.
- Tags common to all items
- : An item, including the slot tag.
- Lock: Optional. When not blank, prevents the container from being opened unless the opener is holding an item whose name matches this string.
- LootTable: Optional. Loot table to be used to fill the hopper when it is next opened, or the items are otherwise interacted with. Note that the loot table is used when the hopper tries to push items, when it's enabled.[note 1]
- LootTableSeed: Optional. Seed for generating the loot table. 0 or omitted uses a random seed.[note 1]
- TransferCooldown: Time until the next transfer in game ticks, naturally between 1 and 8 or 0 if there is no transfer.
- Block entity data
- Tags common to all block entities
- Tags common to all spawners
Note Block/BE
- Block entity data
- Tags common to all block entities
- blockState: The moving block represented by this block entity.
- Block state
- extending: 1 or 0 (true/false) – true if the piston is extending instead of withdrawing.
- facing: Direction that the piston pushes (0=down, 1=up, 2=north, 3=south, 4=west, 5=east).
- progress: How far the block has been moved. Starts at 0.0, and increments by 0.5 each tick. If the value is 1.0 or higher at the start of a tick (before incrementing), then the block transforms into the stored blockState. Negative values can be used to increase the time until transformation.
- source: 1 or 0 (true/false) – true if the block represents the piston head itself, false if it represents a block being pushed.
- Block entity data
- Tags common to all block entities
- IsPlaying: Whether the record is currently playing.
- RecordItem: The item, without the Slot tag.
- Tags common to all items
- RecordStartTick: Value of TickCount when the record started playing.
- TickCount: Count of the number of record-playing ticks this jukebox has processed. Increments only while a record is loaded, whether playing or not.
- Block entity data
- Tags common to all block entities
- GlowingText: 1 or 0 (true/false) - true if the sign has been dyed with a glow ink sac.
- Color: The color that has been used to dye the sign. The default value is "black". One of "white", "orange", "magenta", "light_blue", "yellow", "lime", "pink", "gray", "light_gray", "cyan", "purple", "blue", "brown", "green", "red", or "black".
- Text1: First row of text.
- Text2: Second row of text.
- Text3: Third row of text.
- Text4: Fourth row of text.
- The sign and Hanging Sign share the same structure.
- Block entity data
- Tags common to all block entities
- is_waxed: 1 or 0 (true/false) - true if the text is locked with honeycomb.
- front_text: A compound which discribes front text.
- has_glowing_text: 1 or 0 (true/false) - true if the sign has been dyed with a glow ink sac.
- color: The color that has been used to dye the sign. The default value is
black
One ofwhite
,orange
,magenta
,light_blue
,yellow
,lime
,pink
,gray
,light_gray
,cyan
,purple
,blue
,brown
,green
,red
, andblack
. - messages: A list of text for each line.
- : Text for each line. Must be Raw JSON text format.
- back_text: A compound which discribes back text. The same structure as front_text.
The character limit for the Text tags depends on the width of the characters. Although the Text tags are string objects, they should contain JSON text which are evaluated as compound objects.
- Block entity data
- Tags common to all block entities
- note_block_sound: Optional. The sound event this skull plays when played with a note block.
- ExtraType: Name of the player this is a skull of. This tag is converted to SkullOwner below upon loading the NBT. When loaded sets the name to the value and the UUID to null.
- SkullOwner: The definition of the skull's owner. When this is a
player_head
orplayer_wall_head
, shows this player's skin; if missing, shows the head of the default Steve skin.- Id: UUID of owner, stored as four ints. Optional. Used to update the other tags when the chunk loads or the holder logs in, in case the owner's name has changed.
- Name: Username of owner. If missing or empty, the head appears as a Steve head. Otherwise, used to store or retrieve the downloaded skin in the cache. Need not be a valid player name, but must not be all spaces.
- Properties
- textures
- : An individual texture.
- Value: A Base64-encoded JSON object.
- isPublic: Optional.
- signatureRequired
- profileId: Optional: The hexadecimal text form of the player's UUID, without hyphens.
- profileName: Optional: Player name.
- textures
- CAPE: Optional.
- url: URL of a player cape (64x32 PNG).
- SKIN
- url: URL of a player skin on textures.minecraft.net.
- metadata
- model: The model of the player skin. Can be "classic" or "slim".
- CAPE: Optional.
- timestamp: Optional: Unix time in milliseconds.
- Signature: Optional.
- Value: A Base64-encoded JSON object.
- : An individual texture.
- textures
- Block entity data
- Tags common to all block entities
- author: Author of the structure; only set to "?" for most vanilla structures.
- ignoreEntities: 1 or 0 (true/false): Whether entities should be ignored in the structure.
- integrity: How complete the structure is that gets placed.
- metadata: Value of the data structure block field.
- mirror: How the structure is mirrored, one of "NONE", "LEFT_RIGHT" (mirrored over X axis when not rotated), or "FRONT_BACK" (mirrored over Z axis when not rotated).
- mode: The current mode of this structure block, one of "SAVE", "LOAD", "CORNER", or "DATA".
- name: Name of the structure.
- posX: X-position of the structure.
- posY: Y-position of the structure.
- posZ: Z-position of the structure.
- powered: 1 or 0 (true/false): Whether this structure block is being powered by redstone.
- rotation: Rotation of the structure, one of "NONE", "CLOCKWISE_90", "CLOCKWISE_180", or "COUNTERCLOCKWISE_90".
- seed: The seed to use for the structure integrity, 0 means random.
- showboundingbox: 1 or 0 (true/false): Whether to show the structure's bounding box to players in Creative mode.
- sizeX: X-size of the structure, its length.
- sizeY: Y-size of the structure, its height.
- sizeZ: Z-size of the structure, its depth.
- Block entity data
- Tags common to all block entities
- CustomName: Optional. The name of this container in JSON text component, which appears in its GUI where the default name ordinarily appears.
- Items: List of items in this container.
- : An item, including the slot tag. Dispenser slots are numbered 0-8 with 0 in the top left corner.
- Tags common to all items
- : An item, including the slot tag. Dispenser slots are numbered 0-8 with 0 in the top left corner.
- Lock: Optional. When not blank, prevents the container from being opened unless the opener is holding an item whose name matches this string.
- LootTable: Optional. Loot table to be used to fill the dispenser when it is next opened, or the items are otherwise interacted with.[note 1]
- LootTableSeed: Optional. Seed for generating the loot table. 0 or omitted causes a random seed to be used.[note 1]
Tile tick format
Tile Ticks represent block updates that need to happen because they could not happen before the chunk was saved. Examples reasons for tile ticks include redstone circuits needing to continue updating, water and lava that should continue flowing, recently placed sand or gravel that should fall, etc. Tile ticks are not used for purposes such as leaf decay, where the decay information is stored in the leaf block data values and handled by Minecraft when the chunk loads. For map makers, tile ticks can be used to update blocks after a period of time has passed with the chunk loaded into memory.
- A Tile Tick
- i: The ID of the block; used to activate the correct block update procedure.
- t: The number of ticks until processing should occur. May be negative when processing is overdue.
- p: If multiple tile ticks are scheduled for the same tick, tile ticks with lower p will be processed first. If they also have the same p, the order is unknown.
- x: X position
- y: Y position
- z: Z position
History
Chunks were first introduced in Minecraft Infdev. Before the addition of the MCRegion format in Beta 1.3, chunks were stored as individual chunk files ".dat" where the file names contained the chunk's position encoded in Base36 - this is known as the Alpha level format. MCRegion changed this by storing groups of 32×32 chunks in individual ".mcr" files with the coordinates in Base10, with the goal being to reduce disk usage by cutting down on the number of file handles Minecraft had open at once. MCRegion's successor is the current format, Anvil, which only made changes to the chunk format. The region file technique is still used, but the region file extensions are ".mca" instead.
The major change from MCRegion to Anvil was the division of Chunks into Sections; each chunk has up to 16 individual 16×16×16 block Sections so that completely empty sections will not be saved at all. Preparation has also been made to support blocks with IDs in the range 0 to 4095, as compared to the previous 0 to 255 limitation. However, Minecraft is not fully prepared for such blocks to exist as items; many item IDs are already taken in the range 256 to 4095.
The Blocks, Data, BlockLight, and SkyLight arrays are now housed in individual chunk Sections. The Data, SkyLight, and BlockLight are arrays of 4-bit values, and the BlockLight and SkyLight arrays no longer house part of the block ID. The Blocks array is 8 bits per block, and the 4096-blocks support exists in the form of an optional Add byte array of 4-bits per block for additional block ID information. With the Anvil format, the NBT Format was changed from Notch's original specification to include an integer array tag similar to the existing byte array tag. It is currently only used for HeightMap information in chunks.
release | |||||
---|---|---|---|---|---|
? | Removed MaxExperience , RemainingExperience , ExperienceRegenTick , ExperienceRegenRate and ExperienceRegenAmount from MobSpawner . | ||||
1.4.2 | 12w34a | Added entity WitherBoss . | |||
1.5 | 13w02a | Added entity MinecartTNT .
| |||
Minecart is now deprecated. | |||||
13w03a | Added entity MinecartHopper . | ||||
13w06a | Added entity MinecartSpawner . | ||||
1.6.1 | 13w16a | Added entity EntityHorse . | |||
13w21a | Removed ArmorType from EntityHorse .
| ||||
Removed Saddle from EntityHorse . | |||||
1.6.1-pre | Readded Saddle to EntityHorse . | ||||
1.7.2 | 13w39a | Added entity MinecartCommandBlock . | |||
1.8 | 14w02a | Added Lock to containers.
| |||
Item IDs are no longer used when specifying NBT data. | |||||
Added Block to FallingSand , using the alphabetical ID format. | |||||
14w06a | Added ShowParticles to all mobs.
| ||||
Added PickupDelay to item entities. | |||||
Setting Age to -32768 makes items which never expire. | |||||
Removed AttackTime from mobs. | |||||
14w10a | Added rewardExp to Villager .
| ||||
Added OwnerUUID for mobs that can breed. | |||||
Added Owner to Skull . | |||||
Changes to item frames and paintings: added Facing , TileX , TileY and TileZ now represent the co-ordinates of the block the item is in rather than what it is placed on, deprecated Direction and Dir . | |||||
14w11a | Added entity Endermite .
| ||||
Added EndermiteCount to Enderman . | |||||
14w21a | CustomName and CustomNameVisible now work for all entities. | ||||
14w25a | Added entity Guardian .
| ||||
Added Text1 , Text2 , Text3 and Text4 to signs. The limit no longer depends on the amount of characters (16), it now depends on the width of the characters. | |||||
14w27a | Added entity Rabbit .
Added CommandStats to command blocks and signs. | ||||
14w28a | Removed EndermiteCount from Enderman . | ||||
14w30a | Added Silent for all entities. | ||||
14w32a | Added NoAI for all mobs.
| ||||
Added entity ArmorStand . | |||||
14w32c | Added NoBasePlate to ArmorStand . | ||||
1.9 | 15w31a | Added tags HandItems , ArmorItems , HandDropChances , and ArmorDropChances to Living , which replace the DropChances and Equipment tags.
| |||
Added HandItems and ArmorItems to ArmorStand . | |||||
Added Glowing to Entity . | |||||
Added Team to LivingBase . | |||||
Added DragonPhase to EnderDragon | |||||
Added entity Shulker , child of Entity . | |||||
Added entity ShulkerBullet , child of Entity . | |||||
Added entity DragonFireball , which extends FireballBase and has no unique tags. | |||||
Added entities TippedArrow and SpectralArrow , children of Arrow . | |||||
Added block EndGateway , child of TileEntity . | |||||
Added block Structure , child of TileEntity . | |||||
Added item tag Potion , child of tag . | |||||
15w32a | Tags and DataVersion tag can now be applied on entities.
| ||||
Changed the Fuse tag's type for the PrimedTnt entity from "Byte" to "Short". | |||||
15w32c | Introduced a limit on the amount of tags an entity can have (1024 tags). When surpassed it displays an error saying: "Cannot add more than 1024 tags to an entity." | ||||
15w33a | Added entity AreaEffectCloud , child of Entity .
| ||||
Added ExactTeleport and renamed Life to Age for EndGateway . | |||||
Added Linger to ThrownPotion . | |||||
Removed DataVersion from Entity . It is now only applied to Player only, child of LivingBase . | |||||
Removed UUID from Entity . | |||||
HealF under LivingBase has become deprecated. | |||||
Health under LivingBase has changed from type "Short" to "Float". | |||||
Equipment removed from ArmorStand and Living entity, its usage replaced by HandItems and ArmorItems which were added earlier. | |||||
15w33c | Added BeamTarget to EnderCrystal . | ||||
15w34a | Added powered and conditional byte tags to Control tile entity for command blocks.
| ||||
Added life and power to FireballBase . | |||||
Added id inside SpawnData to MobSpawner . | |||||
Added powered to the Music tile entity for note blocks. | |||||
15w35a | Added VillagerProfession to Zombie . | ||||
15w37a | Added Enabled to MinecartHopper . | ||||
15w38a | Added SkeletonTrap and SkeletonTrapTime to EntityHorse . | ||||
15w41a | Replaced Riding with Passengers for all entities.
| ||||
Added RootVehicle for all passengers. | |||||
Added Type to Boat . | |||||
15w42a | Added Fuel to Cauldron (brewing stands). | ||||
15w43a | Added LootTable and LootTableSeed to Chest , Minecart and MinecartHopper .
| ||||
Added DeathLootTable and DeathLootTableSeed to all mobs. | |||||
Added life and power to all fireballs (FireballBase ). | |||||
15w44a | Added ShowBottom to EnderCrystal . | ||||
15w44b | Added Potion and CustomPotionEffects to Arrow .
| ||||
Added Potion to AreaEffectCloud . | |||||
15w45a | Removed Linger from ThrownPotion . Instead, the potion will linger if the stored item has an ID of minecraft:lingering_potion .
| ||||
ThrownPotion will now render as its stored item even if the item is not a potion. | |||||
15w46a | MoreCarrotTicks from Rabbit is now set to 40 when rabbits eat a carrot crop, but is not used anyway. | ||||
15w47a | Added PaymentItem to Beacon . | ||||
15w49a | Removed PaymentItem from Beacon .
| ||||
In order for a sign to accept text, all 4 tags ("Text1", "Text2", "Text3", and "Text4") must exist. | |||||
15w51b | The original values of DisabledSlots in ArmorStand have changed in nature. | ||||
1.10 | 16w20a | Added entity PolarBear .
| |||
Added ZombieType to Zombie , replacing VillagerProfession and IsVillager . Value of 6 indicates the "husk" zombie. | |||||
A value of 2 on SkeletonType indicates the "stray" skeleton. | |||||
NoGravity extended to all entities. | |||||
Added powered , showboundingbox and showair to Structure . | |||||
16w21a | Added FallFlying to mobs and armor stands.
| ||||
Added integrity and seed to Structure . | |||||
1.10-pre1 | Added ParticleParam1 and ParticleParam2 to AreaEffectCloud . |
Help | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Menu screens |
| ||||||||||||||||||
Game customization | |||||||||||||||||||
Editions |
| ||||||||||||||||||
Miscellaneous |