Chunk format
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.
Contents
- 1 NBT structure
- 2 Block format
- 3 Entity format
- 3.1 Mobs
- 3.1.1 Axolotl color
- 3.1.2 Cat type
- 3.1.3 Collar color
- 3.1.4 Fox types
- 3.1.5 Variant
- 3.1.6 Mooshroom type
- 3.1.7 Genes
- 3.1.8 Parrot color
- 3.1.9 Rabbit Type
- 3.1.10 Sheep color
- 3.1.11 Shulker color
- 3.1.12 Color
- 3.1.13 Villager type
- 3.1.14 Villager profession
- 3.1.15 Collar color
- 3.1.16 Zombie villager type
- 3.1.17 Zombie villager profession
- 3.2 Projectiles
- 3.3 Items and XP Orbs
- 3.4 Vehicles
- 3.5 Dynamic tiles
- 3.6 Other
- 3.1 Mobs
- 4 Block entity format
- 5 Tile tick format
- 6 History
- 7 References
NBT structure[edit]
Chunks are stored as tags in regional Minecraft Anvil files, which are named in the form r.x.z.mca
. They are stored in NBT format, with the following structure (see Block Format for the ordering of the blocks within each array):
- The root tag.
- DataVersion: Version of the chunk NBT structure.
- Level: Chunk data.
- Biomes: May not exist. 1024 entries of biome data. Each number in the array is the biome for a 4x4x4 volume in the chunk. These 4×4×4 volumes are arranged by X, then Z, then Y. That is, the first 4×4 values in the array are for the 16×16 chunk, at Y levels 0–3, the next 4×4 is for Y levels 4–7, etc. See Java Edition data values § Biomes for biome IDs. If this tag does not exist, it gets created and filled by Minecraft when the chunk is loaded and saved. If any values in this array correspond to an unknown biome, Minecraft also sets them to the biome that would normally generate in that location
- CarvingMasks:
- AIR: A series of bits indicating whether a cave has been dug at a specific position, stored in a byte array.
- LIQUID: A series of bits indicating whether an underwater cave has been dug at a specific position, stored in a byte array.
- Entities:[until JE 1.17] Each TAG_Compound in this list defines an entity in the chunk. See Entity Format below. If this list is empty, it becomes a list of End tags (before 1.10, list of Byte tags).
- Heightmaps: Several different heightmaps corresponding to 256 values compacted at 9 bits per value (lowest being 0, highest being 256, both values inclusive). The 9 bit values are stored in an array of 37 longs, each containing 7 values (long = 64 bits, 7 * 9 = 63; the last bit is unused). In versions prior to 1.16 the heightmaps were stored in 36 long values, where the bits were arranged in an uninterrupted "stream" across all values, resulting in all 2304 bits being used.
- MOTION_BLOCKING: The highest block that blocks motion or contains a fluid.
- MOTION_BLOCKING_NO_LEAVES: The highest block that blocks motion or contains a fluid or is in the
minecraft:leaves
tag. - OCEAN_FLOOR: The highest non-air block, solid block.
- OCEAN_FLOOR_WG: The highest block that is neither air nor contains a fluid, for worldgen.
- WORLD_SURFACE: The highest non-air block.
- WORLD_SURFACE_WG: The highest non-air block, for worldgen.
- LastUpdate: Tick when the chunk was last saved.
- Lights: A List of 16 lists that store positions of light sources per chunk section during world generation as shorts.
- LiquidsToBeTicked: A List of 16 TAG_Lists that store positions of "active" liquids that need to be ticked, packed in TAG_Shorts.
- LiquidTicks: Each TAG_Compound in this list is an "active" liquid in this chunk waiting to be updated.
- 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 behaves identically to being set to 0, apart from taking time to build back up to the positives). See Regional Difficulty for more specifics.
- PostProcessing: A List of 16 TAG_Lists that store positions of blocks that need to receive an update when a proto-chunk turns into a full chunk, packed in TAG_Shorts.
- Sections: List of Compound tags, each tag is a sub-chunk of sorts.
- An individual Section.
- 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.
- BlockStates: A variable amount of 64-bit longs, enough to fit 4096 indices. The indices correspond to the ordering of elements in the section's Palette. All indices are the same size in a section, which is the size required to represent the largest index (minimum of 4 bits). If the size of each index is not a factor of 64, the highest bits where no block index fits anymore are unused. Since Java Edition uses big-endian, indices inside one long are in reverse order, but the longs themselves are normally ordered. In versions prior to 1.16, the full range of bits is used, where the remaining bits of a block index continue on the next long value. (See Chunk format#Block_format)
- Palette: Set of different block states used in the chunk.
- A Block
- Name: Namespaced block ID
- Properties: List of block state properties, with [name] being the name of the block state property
- Name: The block state name and its value.
- A Block
- SkyLight: 2048 bytes recording the amount of sunlight or moonlight hitting each block. 4 bits per block.
- Y: The Y index (not coordinate) of this section. No duplicates but some sections may be missing if empty.
- An individual Section.
- Status: Defines the world generation status of this chunk. It is always one of the following: empty, structure_starts, structure_references, biomes, noise, surface, carvers, liquid_carvers, features, light, spawn, heightmaps or full.<ref>mcdata, Minecraft's generated d
- 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 becomes a list of End tags (before 1.10, list of Byte tags).
- TileTicks: 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 or falling sand, and other activity. See Tile Tick Format below.
- ToBeTicked: A List of 16 TAG_Lists that store positions of "active" blocks that need to be ticked, packed in TAG_Shorts.
- Structures: Structure data in this chunk.
- References: Coordinates of chunks that contain Starts.
- Structure Name: Each 64-bit number of this array represents a chunk coordinate (i.e. block coordinate / 16), with its X packed into the low (least significant) 32 bits and Z packed into the high (most significant) 32 bits.
- Starts: Structures that are yet to be generated, stored by general type. Some parts of the structures may have already been generated. Completely generated structures are removed by setting their id to "INVALID" and removing all other tags.
- Structure Name: Only the structures that can spawn in this dimension are stored, for example, EndCity is stored only in the end chunks.
- BB: Bounding box of the entire structure (remaining Children). Value is 6 ints: the minimum X, Y, and Z coordinates followed by the maximum X, Y, and Z coordinates. Absent if id is INVALID.
- biome: The biome id this structure is in. Absent if id is INVALID.
- Children: List of structure pieces making up this structure, that were not generated yet. Absent if id is INVALID.
- Structure piece data. [more information needed]
- BB: Bounding box of the structure piece. (Does not include the part of a village roof that can overhang the road.) Value is 6 ints: the minimum X, Y, and Z coordinates followed by the maximum X, Y, and Z coordinates.
- BiomeType: The ocean temperature this ocean ruins is in. Valid values are WARM and COLD.
- C: (Village "ViSmH") Hut roof type.[verify]
- CA: (Village "ViF" and "ViDF") Crop in the farm plot.[verify]
- Name: Namespaced block ID
- Properties: List of block state properties, with [name] being the name of the block state property
- Name: The block state name and its value.
- CB: (Village "ViF" and "ViDF") Crop in the farm plot.[verify]
- Name: Namespaced block ID
- Properties: List of block state properties, with [name] being the name of the block state property
- Name: The block state name and its value.
- CC: (Village "ViDF") Crop in the farm plot.[verify]
- Name: Namespaced block ID
- Properties: List of block state properties, with [name] being the name of the block state property
- Name: The block state name and its value.
- CD: (Village "ViDF") Crop in the farm plot.[verify]
- Name: Namespaced block ID
- Properties: List of block state properties, with [name] being the name of the block state property
- Name: The block state name and its value.
- Chest: 1 or 0 (true/false) - (Fortress "NeSCLT" and "NeSCRT") Whether this fortress piece should contain a chest but hasn't had one generated yet. (Stronghold "SHCC") Whether this chest in this stronghold piece was placed. (Village "ViS") Whether the blacksmith chest has been generated.
- D: (Mineshaft "MSCrossing") Indicates the "incoming" direction for the crossing.
- Depth: (Temples and huts) Depth of the structure (X/Z).
- Entrances: (Mineshaft "MSRoom") List of exits from the room.
- : Bounding box of the exit.
- EntryDoor: (Stronghold) The type of door at the entry to this piece.
- GD: Appears to be some sort of measure of how far this piece is from the start.
- hasPlacedChest0: 1 or 0 (true/false) - (Desert temple) Whether chest was placed.
- hasPlacedChest1: 1 or 0 (true/false) - (Desert temple) Whether chest was placed.
- hasPlacedChest2: 1 or 0 (true/false) - (Desert temple) Whether chest was placed.
- hasPlacedChest3: 1 or 0 (true/false) - (Desert temple) Whether chest was placed.
- Height: (Temples and huts) Height of the structure (Y).
- HPos: (Temples, huts and villages) Y level the structure was moved to in order to place it on the surface, or -1 if it hasn't been moved yet.[verify]
- hps: 1 or 0 (true/false) - (Mineshaft "MSCorridor") Whether the corridor has a cave spider spawner.
- hr: 1 or 0 (true/false) - (Mineshaft "MSCorridor") Whether the corridor has rails.
- id: Identifier for the structure piece. Typically a heavily abbreviated code rather than something human-readable.
- integrity: The integrity of this structure (only used by ocean ruins).
- isLarge: 1 or 0 (true/false) - If this ocean ruin is big.
- junctions: (Village) List of junction points. [more information needed][verify]
-
- source_x: Block coordinate.
- source_ground_y: Block coordinate.
- source_z: Block coordinate.
- delta_y:
- dest_proj: One of
terrain_matching
orrigid
.
-
- Left: 1 or 0 (true/false) - (Stronghold "SHS") Whether the corridor has an opening on the left.
- leftHigh: 1 or 0 (true/false) - (Stronghold "SH5C") Whether the 5-way crossing has an exit on the upper level on the side with the upward staircase.
- leftLow: 1 or 0 (true/false) - (Stronghold "SH5C") Whether the 5-way crossing has an exit on the lower level on the side with the upward staircase.
- Length: (Village "ViSR") Length of the road piece.[verify]
- Mob: 1 or 0 (true/false) - (Fortress "NeMT") Whether this fortress piece should contain a Blaze spawner but hasn't had one generated yet. (Stronghold "SHPR") Whether the Silverfish spawner has been placed in this piece.
- Num: (Mineshaft "MSCorridor") Corridor length.
- O: Likely orientation of the structure piece.
- placedHiddenChest: 1 or 0 (true/false) - (Jungle temple) Whether the hidden chest was placed.
- placedMainChest: 1 or 0 (true/false) - (Jungle temple) Whether the main chest was placed.
- placedTrap1: 1 or 0 (true/false) - (Jungle temple) Whether the hallway arrow trap dispenser was placed.
- placedTrap2: 1 or 0 (true/false) - (Jungle temple) Whether the chest arrow trap dispenser was placed.
- PosX: The X coordinate origin of this village part.[verify]
- PosY: The Y coordinate origin of this village part.[verify]
- PosZ: The Z coordinate origin of this village part.[verify]
- Right: 1 or 0 (true/false) - (Stronghold "SHS") Whether the corridor has an opening on the right.
- rightHigh: 1 or 0 (true/false) - (Stronghold "SH5C") Whether the 5-way crossing has an exit on the upper level on the side with the downward staircase.
- rightLow: 1 or 0 (true/false) - (Stronghold "SH5C") Whether the 5-way crossing has an exit on the lower level on the side with the downward staircase.
- Rot: Rotation of ocean ruins and shipwrecks. Valid values are COUNTERCLOCKWISE_90, NONE, CLOCKWISE_90, and CLOCKWISE_180.
- sc: 1 or 0 (true/false) - (Mineshaft "MSCorridor") Whether the corridor has cobwebs.
- Seed: (Fortress "NeBEF") Random seed for the broken-bridge fortress piece.
- Source: 1 or 0 (true/false) - (Stronghold "SHSD") Whether the spiral staircase is the source of the Stronghold or was randomly generated.
- Steps: (Stronghold "SHFC") Length of the corridor
- T: (Village "ViSmH") Table: 0 is no table, 1 and 2 place it on either side of the hut.[verify]
- Tall: 1 or 0 (true/false) - (Stronghold "SHLi") Whether the library has an upper level.
- Template: The template of the ocean ruin or shipwreck that was used.
- Terrace: 1 or 0 (true/false) - (Village "ViSH") Whether the house has a ladder to the roof and fencing.[verify]
- tf: 1 or 0 (true/false) - (Mineshaft "MSCrossing") Whether the crossing is two floors tall.
- TPX: The X coordinate origin of this ocean ruin or shipwreck.
- TPY: The Y coordinate origin of this ocean ruin or shipwreck.
- TPZ: The Z coordinate origin of this ocean ruin or shipwreck.
- Type: (Village) Village type: 0=plains, 1=desert, 2=savanna, 3=taiga.[verify]
- Type: (Stronghold "SHRC") Indicates whether the room contains a pillar with torches, a fountain, an upper level with a chest, or is just empty room.
- VCount: (Village) Count of villagers spawned along with this piece.[verify]
- Width: (Temples and huts) Width of the structure (X/Z).
- Witch: 1 or 0 (true/false) - (Witch hut) Whether the initial witch has been spawned for the hut.
- Zombie: 1 or 0 (true/false) - (Village) Whether this village generated as a zombie village.[verify]
- Structure piece data. [more information needed]
- ChunkX: Chunk X coordinate of the start of the structure. Absent if id is INVALID.
- ChunkZ: Chunk Z coordinate of the start of the structure. Absent if id is INVALID.
- id: If there's no structure of this kind in this chunk, this value is "INVALID", else it's the structure name.
- Processed: (Monument only) List of chunks that have had their piece of the structure created. Absent if id is INVALID.
- : A chunk.
- X: The chunk's X position (chunk coordinates, not block coordinates).
- Z: The chunk's Z position.
- : A chunk.
- Valid: 1 or 0 (true/false) - (Village only) Whether the village generated at least 3 non-roads. Absent if id is INVALID.
- Structure Name: Only the structures that can spawn in this dimension are stored, for example, EndCity is stored only in the end chunks.
- References: Coordinates of chunks that contain Starts.
- xPos: X position of the chunk (in chunks, from the origin, not relative to region).
- zPos: Z position of the chunk (in chunks, from the origin, not relative to region).
Block format[edit]
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 upward, decreases downward
- Z increases South, decreases North
This means indices are ordered like in a book, with its top to the North, read from beneath and with words written backward: each letter is a different X-index, each line a Z-index, and each page a Y-index. In case of a flat 2D array, the Y-index is omitted, and the array reads like a single page.
Each section is a 16×16×16-block area, with up to 16 sections in a chunk : from 0 at the bottom, to 15 on top. Empty sections are not saved. Each section has a "Y" byte for its Y-index (0 to 15), a "Palette" list linking IDs to block states, and a "BlockStates" long array storing the IDs per block location, compressed by fitting multiple IDs inside each entry. There is an additional section at the top and bottom of the world used to store light, so that light travels proverly over and under the world limits.
The "BlockLight" byte array is for block light levels. The "SkyLight" byte array stores the maximum sky light that reaches each block, regardless of current time. Each of them are 2048 bytes long, and both are omitted if no light reaches this section of the chunk. Light level is stored as 4 bits per block, 2 blocks sharing a byte : starting at 0, even blocks take the first nibble, and odd blocks the second one. This is the only known instance of small-endian data storage in Java Edition.
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; compound Block = Palette[change_array_element_size(BlockStates,Log2(length(Palette)))[BlockPos]] string BlockName = Block.Name; compound BlockState = Block.Properties; byte Blocklight = Nibble4(BlockLight, BlockPos); byte Skylight = Nibble4(SkyLight, BlockPos);
Entity format[edit]
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:
- Entity data
- Air: How much air the entity has, in ticks. Fills to a maximum of 300 in air, giving 15 seconds submerged before the entity starts to drown, and a total of up to 35 seconds before the entity dies (if it has 20 health). Decreases while underwater. If 0 while underwater, the entity loses 1 health per second.
- 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.
- 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.
- 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 that is riding this entity. Note that both entities control movement and the topmost entity controls spawning conditions when created by a mob spawner.
- See 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 clockwise around the Y axis (called yaw). Due south is 0. Does not exceed 360 degrees.
- 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.
- 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[edit]
Mob Entities | |
---|---|
Entity ID | Name |
axolotl | Axolotl[upcoming: JE 1.17] |
bat | Bat |
bee | Bee |
blaze | Blaze |
cat | Cat |
cave_spider | Cave Spider |
chicken | Chicken |
cod | Cod |
cow | Cow |
creeper | Creeper |
dolphin | Dolphin |
donkey | Donkey |
drowned | Drowned |
elder_guardian | Elder Guardian |
ender_dragon | Ender Dragon |
enderman | Enderman |
endermite | Endermite |
evoker | Evoker |
fox | Fox |
ghast | Ghast |
giant | Giant |
glow_squid | Glow Squid[upcoming: JE 1.17] |
guardian | Guardian |
hoglin | Hoglin |
horse | Horse |
husk | Husk |
illusioner | Illusioner |
iron_golem | Iron Golem |
llama | Llama |
magma_cube | Magma Cube |
mooshroom | Mooshroom |
mule | Mule |
ocelot | Ocelot |
panda | Panda |
parrot | Parrot |
phantom | Phantom |
pig | Pig |
piglin | Piglin |
piglin_brute | Piglin Brute |
pillager | Pillager |
polar_bear | Polar Bear |
pufferfish | Pufferfish |
rabbit | Rabbit |
ravager | Ravager |
salmon | Salmon |
sheep | Sheep |
shulker | Shulker |
silverfish | Silverfish |
skeleton | Skeleton |
skeleton_horse | Skeleton Horse |
slime | Slime |
snow_golem | Snow Golem |
spider | Spider |
strider | Strider |
squid | Squid |
stray | Stray |
trader_llama | Trader Llama[Java Edition only] |
tropical_fish | Tropical Fish |
turtle | Turtle |
vex | Vex |
villager | Villager |
villager_v2 | Villager[Bedrock Edition only] |
vindicator | Vindicator |
wandering_trader | Wandering Trader |
witch | Witch |
wither | Wither |
wither_skeleton | Wither Skeleton |
wolf | Wolf |
zoglin | Zoglin |
zombie | Zombie |
zombie_horse | Zombie Horse |
zombie_villager | Zombie Villager |
zombie_villager_v2 | Zombie Villager[Bedrock Edition only] |
zombified_piglin | Zombified Piglin |
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
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- FromBucket: 1 or 0 (true/false) – if true, indicates the axolotl has been released from a bucket.
- Variant: ID of the axolotl's variant.
Axolotl color
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- BatFlags: 1 when hanging upside-down from a block, 0 when flying.
- Entity data
- Additional fields for mobs that can become angry see Template:Nbt inherit/angerable/template
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- CannotEnterHiveTicks: Time left in ticks until the bee can enter a beehive. Used when the bee is angered and released from the hive by a player, but the hive is smoked by a campfire.
- CropsGrownSincePollination: How many crops the bee has grown since its last pollination. Used to limit number of crops it can grow.
- FlowerPos: Coordinates of the flower the bee is circling.
- X: X coordinate.
- Y: Y coordinate.
- Z: Z coordinate.
- HasNectar: 1 or 0 (true/false) - true if the bee is carrying pollen.
- HasStung: 1 or 0 (true/false) - true if the bee has stung a mob or player.
- HivePos: Coordinates of the bee's hive.
- X: X coordinate.
- Y: Y coordinate.
- Z: Z coordinate.
- TicksSincePollination: Number of ticks passed since the bee's last pollination.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Entity data
- Additional fields for mobs that can be tamed by players see Template:Nbt inherit/tameable/template
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- CatType: The ID of the skin the cat has. Any invalid ID is discarded, resulting in a randomized skin.
- CollarColor: The color of the cat's collar. Present even for stray cats (but does not render); default value is 14.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Entity data
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- 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 and drops 10 experience upon death instead of 1-3. Baby zombies can still control a ridden chicken even if this is set false.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- FromBucket: 1 or 0 (true/false) - Whether the fish had ever been released from a bucket.
- Entity data
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- 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 see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- CanFindTreasure: 1 or 0 (true/false) - if true, this dolphin can lead a player to treasure.
- GotFish: 1 or 0 (true/false) - if true, this dolphin got fish from a player.
- TreasurePosX: This dolphin's X coordinate destination when leading a player to treasure, 0 if
CanFindTreasure
is false. - TreasurePosY: This dolphin's Y coordinate destination when leading a player to treasure, 0 if
CanFindTreasure
is false. - TreasurePosZ: This dolphin's Z coordinate destination when leading a player to treasure, 0 if
CanFindTreasure
is false.
- Entity data
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Tags common to all horses see Template:Nbt inherit/horse/template
- ChestedHorse: 1 or 0 (true/false) - true if the horse has chests. A chested horse that is not a donkey or a mule crashes the game.
- Items: List of items. Only exists if ChestedHorse is true.
- An item, including the Slot tag. Slots are numbered 2 to 16 for donkeys and mules, and none exist for all other horses.
- Tags common to all items see Template:Nbt inherit/item/template
- An item, including the Slot tag. Slots are numbered 2 to 16 for donkeys and mules, and none exist for all other horses.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Tags common to all zombies see Template:Nbt inherit/zombie/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- 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 see Template:Nbt inherit/angerable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- carriedBlockState: Optional. The block carried by the enderman.
- Name: The namespaced ID 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 see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Lifetime: How long the endermite has existed in ticks. Disappears when this reaches around 2400.
- PlayerSpawned: 1 or 0 (true/false) - if true, Endermen will attack the endermite.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Tags common to all mobs spawnable in raids see Template:Nbt inherit/raidable/template
- 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 see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Crouching: 1 or 0 (true/false) – Whether the fox is crouching.
- Sitting: 1 or 0 (true/false) – Whether the fox is sitting.
- Sleeping: 1 or 0 (true/false) – Whether the fox is sleeping.
- Trusted: A list of players that the fox trusts. For a list with more than 2 elements, only the first and the last are considered.
- : The UUID of each trusted player, stored as four ints.
- Type: ID of the fox's type.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- ExplosionPower: The radius of the explosion created by the fireballs the ghast fires. Default value is 1.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- DarkTicksRemaining: How many ticks until the Glow Squid starts glowing. Set to 0 while glowing, positive values mean it's not glowing.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Entity data
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- CannotBeHunted: 1 or 0 (true/false) - if true, piglins do not attack the hoglin. Set to true for hoglins spawned as a part of bastion remnants.
- IsImmuneToZombification: 1 or 0 (true/false) – if true, the hoglin does not transform to a zoglin when in the Overworld and
TimeInOverworld
does not increment. - TimeInOverworld: The number of ticks that the hoglin has existed in the Overworld; the hoglin converts to a zoglin when this is greater than 300.
- Entity data
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Tags common to all horses see Template:Nbt inherit/horse/template
- 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 see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Tags common to all zombies see Template:Nbt inherit/zombie/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Tags common to all mobs spawnable in raids see Template:Nbt inherit/raidable/template
- 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 become angry see Template:Nbt inherit/angerable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- PlayerCreated: 1 or 0 (true/false) - if true, this golem was created by a player and will never attack them.
- Entity data
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- 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 see Template:Nbt inherit/item/template
- DespawnDelay: A timer for trader llamas to despawn, present only in
trader_llama
. - 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 see Template:Nbt inherit/item/template
- 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 see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- 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 see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- 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 see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Tags common to all horses see Template:Nbt inherit/horse/template
- ChestedHorse: 1 or 0 (true/false) - true if the horse has chests. A chested horse that is not a donkey or a mule crashes the game.
- Items: List of items. Only exists if ChestedHorse is true.
- An item, including the Slot tag. Slots are numbered 2 to 16 for donkeys and mules, and none exist for all other horses.
- Tags common to all items see Template:Nbt inherit/item/template
- An item, including the Slot tag. Slots are numbered 2 to 16 for donkeys and mules, and none exist for all other horses.
- Entity data
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Trusting: 1 or 0 (true/false) - true if the ocelot trusts players.
- Entity data
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- HiddenGene: The secondary gene this panda has, that can transfer to the child.
- MainGene: The primary gene this panda has, that determines the behavior and appearance of the panda and that can transfer to the child.
- Entity data
- Additional fields for mobs that can be tamed by players see Template:Nbt inherit/tameable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Variant: Specifies the color variant of the parrot, default is 0.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- AX: The phantom, when not actively attacking, attempts to circle around X,Y,Z =
AX
,AY
,AZ
. Appears to reset to a point above the target player every time the phantom flies up after a swoop. Set to spawn location if not specified. - AY: See
AX
. - AZ: See
AX
. - Size: The size of the phantom. Ranges from
0
to64
, similar to slimes. Unlike slimes, phantoms always have a constant 20× 10 HP, and deal 6
+
Size
damage. Naturally spawned phantoms are always size 0.
- Entity data
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Saddle: 1 or 0 (true/false) - true if there is a saddle on the pig.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- CannotHunt: 1 or 0 (true/false) – if true, the piglin does not attack hoglins. Set to true for piglins spawned as a part of bastion remnants.
- Inventory: Each compound tag in this list is an item in the piglin's inventory.
- An item in the inventory, excluding the Slot tag.
- Tags common to all items see Template:Nbt inherit/itemnoslot/template
- An item in the inventory, excluding the Slot tag.
- IsBaby: 1 or 0 (true/false) – true if the piglin is a baby. May not exist.
- IsImmuneToZombification: 1 or 0 (true/false) – if true, the piglin does not transform to a zombified piglin when in the Overworld.
- TimeInOverworld: The number of ticks that the piglin has existed in the Overworld; the piglin converts to a zombified piglin when this is greater than 300.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Tags common to all mobs spawnable in raids see Template:Nbt inherit/raidable/template
- Inventory: Each compound tag in this list is an item in the pillager's inventory, up to a maximum of 5 slots. Items in two or more slots that can be stacked together are automatically be condensed into one slot. Pillagers don't change their inventory automatically or drop items from it upon death. The inventory is currently unused.[more information needed]
- An item in the inventory, excluding the Slot tag.
- Tags common to all items see Template:Nbt inherit/itemnoslot/template
- An item in the inventory, excluding the Slot tag.
- Entity data
- Additional fields for mobs that can become angry see Template:Nbt inherit/angerable/template
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- FromBucket: 1 or 0 (true/false) - if true, the fish has been released from a bucket.
- PuffState: A value from 0–2. 0 means the fish is deflated, 1 means it is halfway puffed-up, and 2 means it is fully puffed-up.
- Entity data
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- 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 see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Tags common to all mobs spawnable in raids see Template:Nbt inherit/raidable/template
- AttackTick: Attack cooldown for this ravager.
- RoarTick: Roar attack cooldown for this ravager.
- StunTick: Stun attack cooldown for this ravager.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- FromBucket: 1 or 0 (true/false) - Whether the fish had ever been released from a bucket.
- Entity data
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Color: The color of the sheep. Default is 0.
- Sheared: 1 or 0 (true/false) - true if the sheep has been shorn.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- APX: Approximate X coordinate.
- APY: Approximate Y coordinate.
- APZ: Approximate Z coordinate.
- AttachFace: Direction of the block the shulker is attached to.
- 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 see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Entity data
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Tags common to all horses see Template:Nbt inherit/horse/template
- SkeletonTrap: 1 or 0 (true/false) - true if the horse is a trapped skeleton horse. Does not affect horse type.
- SkeletonTrapTime: Incremented each tick when SkeletonTrap is set to 1. The horse automatically despawns when it reaches 18000 (15 minutes).
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- 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.
- wasOnGround: 1 or 0 (true/false) - true if the slime is touching the ground.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- 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 see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Entity data
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Saddle: 1 or 0 (true/false) - true if the strider is saddled.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Entity data
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- 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 see Template:Nbt inherit/item/template
- DespawnDelay: A timer for trader llamas to despawn, present only in
trader_llama
. - 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 see Template:Nbt inherit/item/template
- 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 see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- FromBucket: 1 or 0 (true/false) - Whether the fish had ever been released from a bucket.
- Variant: A 4-byte integer.
- The least significant byte has a value of either 0 for a small fish, or 1 for a large fish. Values above 1 result in an invisible fish.
- The next byte has a value from 0–5, representing the pattern on the fish. Values above 5 result in a fish with no pattern.
- The next byte has a value from 0–15, representing the color of the fish's body.
- The most significant byte has a value from 0–15, representing the color of the fish's pattern.
Color
The fish sizes and patterns are depicted in the following table, with white body color and dark-gray pattern color.
second-least byte | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
0 | 1 | 2 | 3 | 4 | 5 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
least byte |
1 |
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
0 |
The 22 varieties of tropical fish most commonly found throughout the world have Variant
tag values from the following table, which also lists what color/shape/patterns come from that value.
Shape | Pattern | Base color | Pattern color | Variant | Name |
---|---|---|---|---|---|
0 | 0 | 1 | 0 | 65536 | Orange-White Kob |
0 | 0 | 14 | 0 | 917504 | Red-White Kob |
1 | 3 | 14 | 0 | 918273 | Red-White Blockfish |
1 | 4 | 14 | 0 | 918529 | Red-White Betty |
1 | 5 | 0 | 1 | 16778497 | White-Orange Clayfish |
0 | 4 | 5 | 3 | 50660352 | Lime-Sky Brinely |
0 | 5 | 6 | 3 | 50726144 | Rose-Sky Spotty |
0 | 1 | 7 | 3 | 50790656 | Gray-Sky SunStreak [Bedrock Edition only] |
1 | 0 | 0 | 4 | 67108865 | White-Yellow Flopper |
0 | 5 | 0 | 4 | 67110144 | White-Yellow Spotty |
1 | 1 | 4 | 4 | 67371265 | Yellow Stripey |
1 | 3 | 10 | 4 | 67764993 | Plum-Yellow Blockfish |
0 | 3 | 9 | 6 | 101253888 | Teal-Rose Dasher |
1 | 2 | 0 | 7 | 117441025 | White-Gray Glitter |
0 | 3 | 0 | 7 | 117441280 | White-Gray Dasher |
0 | 4 | 0 | 7 | 117441536 | White-Gray Brinely |
1 | 1 | 1 | 7 | 117506305 | Orange-Gray Stripey |
1 | 0 | 7 | 7 | 117899265 | Gray Flopper |
0 | 1 | 11 | 7 | 118161664 | Blue-Gray SunStreak |
0 | 1 | 0 | 8 | 134217984 | White-Silver Sunstreak |
1 | 0 | 7 | 11 | 185008129 | Gray-Blue Flopper [Java Edition only] |
1 | 5 | 0 | 14 | 234882305 | White-Red Clayfish |
0 | 2 | 7 | 14 | 235340288 | Gray-Red Snooper |
The variant number is the sum of the most significant byte × 224 + second most significant byte × 216 + second least significant byte × 28 + least significant byte.
- Entity data
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- HasEgg: 1 or 0 (true/false) - true if the turtle has an egg.
- HomePosX: The X coordinate the turtle travels toward to lay its eggs after breeding.
- HomePosY: The Y coordinate the turtle travels toward to lay its eggs after breeding.
- HomePosZ: The Z coordinate the turtle travels toward to lay its eggs after breeding.
- TravelPosX: Used for swimming to random points in water.
- TravelPosY: Used for swimming to random points in water.
- TravelPosZ: Used for swimming to random points in water.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- 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, it is the location the vex first attempted to idly wander. - 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 see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Tags common to all villagers see Template:Nbt inherit/villager/template
- 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 be 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 see Template:Nbt inherit/itemnoslot/template
- 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 see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Tags common to all mobs spawnable in raids see Template:Nbt inherit/raidable/template
- 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 breed see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- DespawnDelay: The number of ticks until this wandering trader is forced to despawn.
- Offers: Is generated when the trading menu is opened for the first time.
- Recipes: List of trade options.
- A trade option.
- buy: The first 'cost' item, without the Slot tag.
- Tags common to all items see Template:Nbt inherit/itemnoslot/template
- buyB: May not exist. The second 'cost' item, without the Slot tag.
- Tags common to all items see Template:Nbt inherit/itemnoslot/template
- maxUses: The maximum number of times this trade can be used before it is disabled. Increases by a random amount from 2 to 12 when offers are refreshed.
- rewardExp: 1 or 0 (true/false) - true if this trade provides XP orb drops. All trades from naturally-generated villagers in Java Edition reward XP orbs.
- sell: The item being sold for each set of cost items, without the Slot tag.
- Tags common to all items see Template:Nbt inherit/itemnoslot/template
- uses: The number of times this trade has been used. The trade becomes disabled when this is greater or equal to maxUses.
- buy: The first 'cost' item, without the Slot tag.
- A trade option.
- Recipes: List of trade options.
- WanderTarget: Destination toward where this trader wanders.
- X: The X coordinate to wander toward.
- Y: The Y coordinate to wander toward.
- Z: The Z coordinate to wander toward.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Tags common to all mobs spawnable in raids see Template:Nbt inherit/raidable/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Invul: The number of ticks of invulnerability left after being initially created. 0 once invulnerability has expired.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Entity data
- Additional fields for mobs that can become angry see Template:Nbt inherit/angerable/template
- Additional fields for mobs that can be tamed by players see Template:Nbt inherit/tameable/template
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- 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 see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- IsBaby: 1 or 0 (true/false) - true if the zoglin is a baby. May not exist.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Tags common to all zombies see Template:Nbt inherit/zombie/template
- Entity data
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Tags common to all horses see Template:Nbt inherit/horse/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Tags common to all villagers see Template:Nbt inherit/villager/template
- Tags common to all zombies see Template:Nbt inherit/zombie/template
- ConversionTime: -1 when not being converted back to a villager, positive for the number of ticks until conversion back into a villager. The regeneration effect parallels this.
- ConversionPlayer: The UUID of the player who started curing the zombie, stored as four ints.
Zombie villager type
Zombie villager profession
- Entity data
- Additional fields for mobs that can become angry see Template:Nbt inherit/angerable/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Tags common to all zombies see Template:Nbt inherit/zombie/template
Projectiles[edit]
Projectile Entities | |
---|---|
Entity ID | Name |
arrow | Arrow |
dragon_fireball | Ender Dragon Fireball |
egg | Egg |
ender_pearl | Ender Pearl |
experience_bottle | Bottle o' Enchanting |
fireball | Ghast Fireball |
firework_rocket | Firework Rocket |
llama_spit | Llama spit |
potion | Splash Potion |
small_fireball | Blaze Fireball/Fire Charge |
shulker_bullet | Shulker Bullet |
snowball | Snowball |
spectral_arrow | Spectral Arrow[Java Edition only] |
trident | Trident |
wither_skull | Wither Skull |
Projectiles are a subclass of Entity.
- Entity data
- Tags common to all arrows see Template:Nbt inherit/arrow/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all projectiles see Template:Nbt inherit/projectile/template
- An arrow entity is a tipped arrow if it has either the
Potion
orCustomPotionEffects
tag. Thetipped_arrow
item uses these tags, but thearrow
item does not.- Tags common to all potion effects see Template:Nbt inherit/potion/template
- 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 see Template:Nbt inherit/entity/template
- Tags common to all fireballs see Template:Nbt inherit/fireball/template
- Tags common to all projectiles see Template:Nbt inherit/projectile/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all projectiles see Template:Nbt inherit/projectile/template
- Item: The item to render as, may be absent.
- Tags common to all items see Template:Nbt inherit/itemnoslot/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all projectiles see Template:Nbt inherit/projectile/template
- Item: The item to render as, may be absent.
- Tags common to all items see Template:Nbt inherit/itemnoslot/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all projectiles see Template:Nbt inherit/projectile/template
- Item: The item to render as, may be absent.
- Tags common to all items see Template:Nbt inherit/itemnoslot/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all fireballs see Template:Nbt inherit/fireball/template
- Tags common to all projectiles see Template:Nbt inherit/projectile/template
- ExplosionPower: The power and size of the explosion created by the fireball upon impact. Default value 1.
- Item: The item to render as, may be absent.
- Tags common to all items see Template:Nbt inherit/itemnoslot/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all projectiles see Template:Nbt inherit/projectile/template
- FireworksItem: The crafted firework rocket.
- id: The id of the item, should be
minecraft:firework_rocket
. - Count: The item count, typically 1.
- tag: The tag tag.
- Fireworks: The firework rocket's item data.
- Explosions: List of compounds representing each explosion this firework causes.
- Explosion: One of the explosions.
- Colors: Array of integer values corresponding to the primary colors of this firework's explosion. If custom color codes are used, the game renders it as "Custom" in the tooltip, but the proper color is used in the explosion. Custom colors are integers in the same format as the color tag from Display Properties.
- FadeColors: Array of integer values corresponding to the fading colors of this firework's explosion. Same handling of custom colors as Colors. May be absent.
- Flicker: 1 or 0 (true/false) - true if this explosion has the Twinkle effect (glowstone dust). May be absent.
- Trail: 1 or 0 (true/false) - true if this explosion has the Trail effect (diamond). May be absent.
- Type: The shape of this firework's explosion. 0 = Small Ball, 1 = Large Ball, 2 = Star-shaped, 3 = Creeper-shaped, 4 = Burst. Other values are named "Unknown Shape" and render as Small Ball.
- Explosion: One of the explosions.
- Flight: Indicates the flight duration of the firework (equals the amount of gunpowder used in crafting the rocket). While this value can be anything from -128 to 127, values of -2 and under almost never detonate at all.
- Explosions: List of compounds representing each explosion this firework causes.
- Fireworks: The firework rocket's item data.
- id: The id of the item, should be
- 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 if the firework was shot from a crossbow, 0 otherwise.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all projectiles see Template:Nbt inherit/projectile/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all projectiles see Template:Nbt inherit/projectile/template
- 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 see Template:Nbt inherit/itempotion/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all projectiles see Template:Nbt inherit/projectile/template
- 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 (similar to fireballs).
- 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.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all fireballs see Template:Nbt inherit/fireball/template
- Tags common to all projectiles see Template:Nbt inherit/projectile/template
- Item: The item to render as, may be absent.
- Tags common to all items see Template:Nbt inherit/itemnoslot/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all projectiles see Template:Nbt inherit/projectile/template
- Item: The item to render as, may be absent.
- Tags common to all items see Template:Nbt inherit/itemnoslot/template
- Entity data
- Tags common to all arrows see Template:Nbt inherit/arrow/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all projectiles see Template:Nbt inherit/projectile/template
- Duration: The time in ticks that the Glowing effect persists.
- Entity data
- Tags common to all arrows see Template:Nbt inherit/arrow/template
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all projectiles see Template:Nbt inherit/projectile/template
- DealtDamage: 1 or 0 (true/false) - true if the trident has already damaged an entity, in which case subsequent collisions with entities deal no damage.
- Trident: The tag representing the item that is given when the entity is picked up.
- Tags common to all items see Template:Nbt inherit/itemnoslot/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all fireballs see Template:Nbt inherit/fireball/template
- Tags common to all projectiles see Template:Nbt inherit/projectile/template
Items and XP Orbs[edit]
Item Entities | |
---|---|
Entity ID | Name |
experience_orb | Experience Orb |
item | Dropped Item |
Items and XPOrbs are a subclass of Entity.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Age: The number of ticks the XP orb has been "untouched". After 6000 ticks (5 minutes) the orb is destroyed.
- Count:[upcoming: JE 1.17] 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. However, this value is stored as a byte in saved data, and read as a short but clipped to the range of a byte. As a result, its range is 0-255, always positive, and values exceeding 255 overflow.
- Value: The amount of experience the orb gives when picked up.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- 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, falling anvils,[Java Edition only] and explosions. The item is destroyed when its health reaches 0.
- Item: The inventory item, without the Slot tag.
- Tags common to all items see Template:Nbt inherit/itemnoslot/template
- 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.
Vehicles[edit]
Vehicle Entities | |
---|---|
Entity ID | Name |
boat | Boat |
minecart | Minecart |
chest_minecart | Minecart with Chest |
command_block_minecart | Minecart with Command Block |
furnace_minecart | Minecart with Furnace |
hopper_minecart | Minecart with Hopper |
spawner_minecart | Minecart with Spawner |
tnt_minecart | Minecart with TNT |
Vehicles are subclasses of Entity.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Type: The wood type of the boat. Valid types are
oak
,spruce
,birch
,jungle
,acacia
,dark_oak
.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all minecarts see Template:Nbt inherit/vehicle/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all minecarts see Template:Nbt inherit/vehicle/template
- Items: List of items.
- An item, including the Slot tag. Slots are numbered 0 to 26.
- Tags common to all items see Template:Nbt inherit/item/template
- An item, including the Slot tag. Slots are numbered 0 to 26.
- 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. If 0 or omitted, a random seed is used.[note 1]
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all minecarts see Template:Nbt inherit/vehicle/template
- 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.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all minecarts see Template:Nbt inherit/vehicle/template
- 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 see Template:Nbt inherit/entity/template
- Tags common to all minecarts see Template:Nbt inherit/vehicle/template
- Enabled: Determines whether or not the minecart hopper picks up items into its inventory.
- Items: List of items.
- An item, including the Slot tag. Slots are numbered 0 to 4.
- Tags common to all items see Template:Nbt inherit/item/template
- An item, including the Slot tag. Slots are numbered 0 to 4.
- LootTable: Optional. Loot table to be used to fill the hopper 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]
- 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 see Template:Nbt inherit/entity/template
- Tags common to all minecarts see Template:Nbt inherit/vehicle/template
- Tags common to all spawners see Template:Nbt inherit/spawner/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all minecarts see Template:Nbt inherit/vehicle/template
- TNTFuse: Time until explosion or -1 if deactivated.
Dynamic tiles[edit]
Dynamic Block Entities | |
---|---|
Entity ID | Name |
falling_block | Dynamic Tile |
tnt | TNT |
Dynamic tiles are a subclass of Entity and are used to simulate realistically moving blocks.
- Dynamic block entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- BlockState: The falling block represented by this entity.
- Name: The namespaced ID of the block.
- Properties: Optional. The block states of the block.
- Name: The block state name and its value.
- 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 always 2. - FallHurtMax: The maximum hit points of damage to inflict on entities that intersect this
falling_block
. For vanilla falling_block, 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. If set to 0, the moment it ticks to 1, it vanishes if the block at its location has a different ID than the entity's
TileID
. If the block at its location has the same ID as itsTileID
whenTime
ticks from 0 to 1, the block is deleted, and the entity continues to fall, having overwritten it. When Time goes above 600, or above 100 while the block is below Y=0,[verify] the entity is deleted.
- Dynamic block entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Fuse: Ticks until explosion. Default is 0. If activated from a TNT block, the fuse duration is 80 ticks (4 seconds).
Other[edit]
Other Entities | |
---|---|
Entity ID | Name |
area_effect_cloud | Area Effect Cloud |
armor_stand | Armor Stand |
end_crystal | End Crystal |
evoker_fangs | Evoker Fangs |
eye_of_ender | Eye of Ender |
fishing_bobber | Fishing Bobber |
item_frame | Item Frame |
leash_knot | Lead Knot |
lightning_bolt | Lightning Bolt |
painting | Painting |
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 see Template:Nbt inherit/entity/template
- 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 see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template except LeftHanded, DeathLootTable, DeathLootTableSeed, NoAI, Leash, CanPickUpLoot and PersistenceRequired.
- 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[edit]
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 |
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- BeamTarget: The block location its beam points to.
- X: X-coordinate.
- Y: Y-coordinate.
- Z: Z-coordinate.
- ShowBottom: 1 or 0 (true/false) – if true, the End Crystal shows the bedrock slate underneath. Defaults to false when placing by hand and true using
/summon
.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- 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 see Template:Nbt inherit/entity/template
- Item: The item to render as, may be absent.
- Tags common to all items see Template:Nbt inherit/itemnoslot/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all hangables see Template:Nbt inherit/hangable/template
- 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, 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 see Template:Nbt inherit/itemnoslot/template
- 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 see Template:Nbt inherit/entity/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all hangables see Template:Nbt inherit/hangable/template
- Motive: The namespaced ID of the painting's artwork.
Block entity format[edit]
Block Entities | |
---|---|
Block Entity ID | Associated Block |
banner | Banner |
barrel | Barrel |
beacon | Beacon |
bed | Bed |
beehive | Bee nest/hive |
bell | Bell |
blast_furnace | Blast Furnace |
brewing_stand | Brewing Stand |
campfire | Campfire |
cauldron | Cauldron[BE only] |
chest | Chest |
comparator | Redstone Comparator |
command_block | Command Block |
conduit | Conduit |
daylight_detector | Daylight Detector |
dispenser | Dispenser |
dropper | Dropper |
enchanting_table | Enchanting Table |
ender_chest | Ender Chest |
end_gateway | End Gateway |
end_portal | End Portal |
furnace | Furnace |
hopper | Hopper |
jigsaw | Jigsaw Block |
jukebox | Jukebox |
lectern | Lectern |
mob_spawner | Spawner |
piston | Moving Piston |
shulker_box | Shulker Box |
sign | Sign |
skull | Mob head |
smoker | Smoker |
soul_campfire | Soul Campfire |
structure_block | Structure Block |
trapped_chest | Trapped Chest |
A block entity (not related to entity) is used by Minecraft to store information about a block that can't be stored in the block's block states. 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 see Template:Nbt inherit/blockentity/template
- 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 see Template:Nbt inherit/blockentity/template
- 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 the container.
- : An item, including the slot tag. Barrel slots are numbered 0-26, 0 starts in the top left corner.
- Tags common to all items see Template:Nbt inherit/item/template
- : An item, including the slot tag. Barrel 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 barrel 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]
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- 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.
- Primary: The primary power selected, see Potion effects for IDs. 0 means none.
- Secondary: The secondary power selected, see Potion effects for IDs. 0 means none.
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- color:[Bedrock Edition only] 0–15: The data value that determines the color of the half-bed block. When a bed is broken, the color of the block entity of the bed's head becomes the color of the bed item when it drops.
Data value | Description | ||
---|---|---|---|
Dec | Hex | ||
0 | 0x0 | White bed | |
1 | 0x1 | Orange bed | |
2 | 0x2 | Magenta bed | |
3 | 0x3 | Light blue bed | |
4 | 0x4 | Yellow bed | |
5 | 0x5 | Lime bed | |
6 | 0x6 | Pink bed | |
7 | 0x7 | Gray bed | |
8 | 0x8 | Light gray bed | |
9 | 0x9 | Cyan bed | |
10 | 0xA | Purple bed | |
11 | 0xB | Blue bed | |
12 | 0xC | Brown bed | |
13 | 0xD | Green bed | |
14 | 0xE | Red bed | |
15 | 0xF | Black bed |
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- Bees: Entities currently in the hive.
- An entity in the hive.
- EntityData: The NBT data of the entity in the hive.
- See entity format.
- MinOccupationTicks: The minimum amount of time in ticks for this entity to stay in the hive.
- TicksInHive: The amount of ticks the entity has stayed in the hive.
- EntityData: The NBT data of the entity in the hive.
- An entity in the hive.
- FlowerPos: Stores the location of a flower, so other bees can go to it.
- X: X coordinate of the flower.
- Y: Y coordinate of the flower.
- Z: Z coordinate of the flower.
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- 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 blast 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 see Template:Nbt inherit/item/template
- : An item in the blast 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.
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- 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.
- Items: List of items in this container.
- : An item in the brewing stand, including the slot tag:
Slot 0: Left.
Slot 1: Middle.
Slot 2: Right.
Slot 3: Where potion ingredient goes.
Slot 4: Fuel (Blaze Powder).- Tags common to all items see Template:Nbt inherit/item/template
- : 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 see Template:Nbt inherit/blockentity/template
- CookingTimes: How long each item has been cooking, first index is slot 0, etc.
- CookingTotalTimes: How long each item has to cook, first index is slot 0, etc.
- Items: List of up to 4 items currently cooking.
- Tags common to all items see Template:Nbt inherit/item/template
- Block entity data[BE only]
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- CustomColor: This tag exists only if the cauldron stores dyed water (i.e. PotionId is -1 and the block data value is greater than 0); stores a 32-bit ARGB encoded color.
- isMovable: Whether the cauldron can be pushed by pistons; either 0 (false) or 1 (true). The default is 1 (true).
- Items: List of items in this container.
- : An item, including the slot tag. Unsure of what this is used for.
- Tags common to all items see Template:Nbt inherit/item/template
- : An item, including the slot tag. Unsure of what this is used for.
- PotionId: If the cauldron contains a potion, this tag stores the ID of that potion. If there is no potion stored, then this tag is set to -1.
- SplashPotion: Whether the cauldron stores a splash potion; either 0 (false) or 1 (true).
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- 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 see Template:Nbt inherit/item/template
- : 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]
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- OutputSignal: Represents the strength of the analog signal output of this redstone comparator.
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- 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 gamerule commandBlockOutput is false. 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. Only updated when the command block is activated with a redstone signal.
- 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.
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- Target: The UUID of the hostile mob the conduit is currently attacking, stored as four ints. May not be present.
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- 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 see Template:Nbt inherit/item/template
- : 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]
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- 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 see Template:Nbt inherit/item/template
- : 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]
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- CustomName: Optional. The name of this container in JSON text component, which appears in its GUI where the default name ordinarily appears.
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- 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.
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- 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 see Template:Nbt inherit/item/template
- : 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.
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- 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 see Template:Nbt inherit/item/template
- : 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.
- TransferCooldown: Time until the next transfer in game ticks, naturally between 1 and 8 or 0 if there is no transfer.[note 1]
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- final_state: The block that this jigsaw block becomes.
- joint: The joint option value, either "rollable" or "aligned".
- name: The jigsaw block's name. This jigsaw block will be aligned with another structure's jigsaw block which has this value in the target tag.
- pool: The jigsaw block's target pool to select a structure from.
- target: The jigsaw block's target name. This jigsaw block will be aligned with another structure's jigsaw block which has this value in the name tag.
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- RecordItem: The item, without the Slot tag.
- Tags common to all items see Template:Nbt inherit/itemnoslot/template
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- Book: The book item, without the slot tag, currently on the lectern, may not exist.
- Tags common to all items see Template:Nbt inherit/itemnoslot/template
- Page: The page the book is currently on, starting from 0, does not exist if there's no book.
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- Tags common to all spawners see Template:Nbt inherit/spawner/template
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- blockState: The moving block represented by this block entity.
- Name: The namespaced ID of the block.
- Properties: Optional. The block states of the block.
- Name: The block state name and its value.
- extending: 1 or 0 (true/false) – true if the block is being pushed.
- 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.
- 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 see Template:Nbt inherit/blockentity/template
- 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. Shulker box slots are numbered 0–26, 0 starts in the top left corner.
- Tags common to all items see Template:Nbt inherit/item/template
- : An item, including the slot tag. Shulker box 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 shulker box 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]
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- 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.
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- 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.
- 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.
- 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 see Template:Nbt inherit/blockentity/template
- 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 smoker, 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 see Template:Nbt inherit/item/template
- : An item in the smoker, 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.
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- CookingTimes: How long each item has been cooking, first index is slot 0, etc.
- CookingTotalTimes: How long each item has to cook, first index is slot 0, etc.
- Items: List of up to 4 items currently cooking.
- Tags common to all items see Template:Nbt inherit/item/template
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- 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 see Template:Nbt inherit/blockentity/template
- 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 see Template:Nbt inherit/item/template
- : 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]
Tile tick format[edit]
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.
- p: If multiple tile ticks are scheduled for the same tick, tile ticks with lower p are processed first. If they also have the same p, the order is unknown.
- t: The number of ticks until processing should occur. May be negative when processing is overdue.
- x: X position
- y: Y position
- z: Z position
History[edit]
Please update this section to reflect recent updates or newly available information.
Chunks were first introduced in Java Edition 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 Java Edition 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 made changes only 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 are not 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 used only for HeightMap information in chunks.
Java Edition | |||||
---|---|---|---|---|---|
1.3.1 | 12w21a | MaxExperience , RemainingExperience , ExperienceRegenTick , ExperienceRegenRate and ExperienceRegenAmount from MobSpawner have been removed. | |||
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 | ArmorType has been removed from EntityHorse .
| ||||
Saddle has been removed from EntityHorse . | |||||
release | Saddle to EntityHorse has been re-added. | ||||
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. | |||||
AttackTime has been removed 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. Direction and Dir are now deprecated. | |||||
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 | EndermiteCount has been removed 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 now 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 now 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 . | |||||
DataVersion from Entity has been removed. It is now applied to Player only, child of LivingBase . | |||||
UUID from Entity has been removed. | |||||
HealF under LivingBase has now become deprecated. | |||||
Health under LivingBase has now changed from type "Short" to "Float". | |||||
Equipment has been removed from ArmorStand and Living entity, its usage is now 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 | Riding has been replaced 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 | Linger has been removed from ThrownPotion . Instead, the potion lingers if the stored item has an ID of minecraft:lingering_potion .
| ||||
ThrownPotion now renders 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 | PaymentItem has been removed 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 been 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 . | |||||
pre1 | Added ParticleParam1 and ParticleParam2 to AreaEffectCloud . | ||||
1.11 | 16w32a | Horses have been split into entity IDs horse , donkey , mule , skeleton_horse and zombie_horse for their respective types. Type and HasReproduced removed from horse , ChestedHorse and Items tags now apply only to mule and donkey , and SkeletonTrap and SkeletonTrapTime tags now apply only to skeleton_horse .
| |||
Skeletons have been split into entity IDs skeleton , stray and wither_skeleton . SkeletonType tag is removed from all skeleton types. | |||||
Zombies have been split into entity IDs zombie , zombie_villager and husk . ZombieType tag is removed from all zombie types, ConversionTime and Profession tags now apply only to zombie_villager . | |||||
Guardians have been split into entity IDs guardian and elder_guardian . Elder tag has been removed from guardian . | |||||
Unused savegame IDs Mob and Monster have been removed. | |||||
Pumpkin byte tag has been added to snowman . | |||||
16w35a | Added CustomName to banner . | ||||
16w39a | Added llama , llama_spit , vindication_illager , vex , evocation_fangs and evocation_illager .
| ||||
Added Color to shulker . | |||||
Added LocName , CustomPotionColor and ColorMap to items. | |||||
16w40a | Added Johnny to vindication_illager .
| ||||
Removed xTile , yTile , zTile , inTile , inGround from the FireballBase class (in large fireballs, small fireballs, dragon fireballs, and wither skulls). | |||||
16w41a | llama_spit is now available as a save game entity. | ||||
16w42a | Added crit to arrow . | ||||
16w43a | Added OwnerUUIDLeast and OwnerUUIDMost to evocation_fangs . | ||||
16w44a | xTile , yTile , zTile , inTile , inGround have been removed from the fishing bobber entity. | ||||
pre1 | ench has been changed to require at least one compound. | ||||
1.12 | 17w13a | Added entity Parrot , ShoulderEntityLeft /ShoulderEntityRight , seenCredits , recipeBook and Recipes . | |||
17w14a | Added isFilteringCraftable , isGuiOpen and recipes to recipeBook , which is now a compound tag.
| ||||
Added ConversionPlayerLeast and ConversionPlayerMost to entity Zombie . | |||||
17w16a | NBT parsing in commands has been improved. | ||||
17w17a | Added toBeDisplayed to recipeBook , UpdateLastExecution and LastExecution . | ||||
17w17b | Added LoveCauseLeast and LoveCauseMost to breedable entities. | ||||
1.13 | 17w47a | The damage tag from items removed, tools and armor now use Damage and maps use map , both in tag .
| |||
Endermen's carried and carriedData merged into carriedBlockState . | |||||
Arrows' inTile and inData merged into inBlockState . | |||||
Minecarts' DisplayTile and DisplayData merged into DisplayState . | |||||
Falling blocks' Block and Data merged into BlockState . | |||||
Moving pistons' BlockId and BlockData merged into blockState . | |||||
Removed note block and flower pot block entities. | |||||
Trapped chests now have their own block entity trapped_chest . | |||||
Removed Base from banners. | |||||
Removed Rot from heads. | |||||
17w47a | Removed Record from jukeboxes. | ||||
17w47b | Trapped chests no longer have their own block entity, and again use chest . | ||||
18w01a | Thrower and Owner has been changed from strings to compounds with two longs named L and M . | ||||
18w02a | Bobbers created by fishing rods now have the entity ID fishing_bobber .
| ||||
Painting motives are now lowercased and namespaced. | |||||
18w07a | Added turtle , trident , and phantom entities.
| ||||
Added HomePosX , HomePosY , HomePosZ , TravelPosX , TravelPosY , TravelPosZ , and HasEgg to turtle . | |||||
Added AX , AY , AZ , and Size to phantom . | |||||
18w15a | Added dolphin entity. | ||||
18w19a | Renamed puffer_fish to pufferfish . | ||||
18w20a | Renamed cod_mob to cod .
| ||||
Renamed salmon_mob to salmon . | |||||
18w21a | Added TreasurePosX , TreasurePosY , TreasurePosZ , GotFish , and CanFindTreasure to dolphin .
| ||||
ench has been renamed to Enchantments . | |||||
Enchantments no longer accepts numeric IDs, and instead requires name IDs. | |||||
pre5 | Renamed xp_orb to experience_orb .
| ||||
Renamed xp_bottle to experience_bottle . | |||||
Renamed eye_of_ender_signal to eye_of_ender . | |||||
Renamed ender_crystal to end_crystal . | |||||
Renamed fireworks_rocket to firework_rocket . | |||||
Renamed commandblock_minecart to command_block_minecart . | |||||
Renamed villager_golem to iron_golem . | |||||
Renamed evocation_fangs to evoker_fangs . | |||||
Renamed evocation_illager to evoker . | |||||
Renamed vindication_illager to vindicator . | |||||
Renamed illusion_illager to illusioner . | |||||
1.14 | 18w43a | Added illager_beast , panda , and pillager entities. | |||
18w45a | The LIGHT_BLOCKING heightmap has been removed. | ||||
1.15 | 19w36a | The Biomes array in the Level tag for each chunk now contains 1024 integers instead of 256, allowing biomes to differ based on altitude. | |||
Upcoming Java Edition | |||||
1.17 | 20w51a | Added axolotl . | |||
21w03a | Added glow_squid . |
References[edit]
Versions | |||
---|---|---|---|
Development |
| ||
Technical |
| ||
Multiplayer | |||
Game customization |