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.
Περιεχόμενα
NBT structure[επεξεργασία | επεξεργασία κώδικα]
- See also: Information from the Anvil format page
Chunks are stored in NBT format, with this structure (see Block Format below for the ordering of the blocks within each array):
- The root tag.
- DataVersion: Version of the chunk NBT structure.
- Level: Chunk data.
- xPos: X position of the chunk.
- zPos: Z position of the chunk.
- LastUpdate: Tick when the chunk was last saved.
- LightPopulated: 1 or 0 (true/false) - If true, the server/client has already calculated lighting values for this chunk after generation.
- TerrainPopulated: 1 or not present (true/false) indicate whether the terrain in this chunk was populated with special things. (Ores, special blocks, trees, dungeons, flowers, waterfalls, etc.) If set to zero then Minecraft will regenerate these features in the blocks that already exist.
- V: Currently always saved as 1 and not actually loaded by the game. Likely a chunk version tag.
- InhabitedTime: The cumulative number of ticks players have been in this chunk. Note that this value increases faster when more players are in the chunk. Used for regional difficulty: increases the chances of mobs spawning with equipment, the chances of that equipment having enchantments, the chances of spiders having potion effects, the chances of mobs having the ability to pick up dropped items, and the chances of zombies having the ability to spawn other zombies when attacked. Note that at values 3600000 and above, regional difficulty is effectively maxed for this chunk. At values 0 and below, the difficulty is capped to a minimum (thus, if this is set to a negative number, it will behave identically to being set to 0, apart from taking time to build back up to the positives). See Regional Difficulty for more specifics.
- Biomes: May not exist. 256 bytes of biome data, one byte for each vertical column in the chunk. See Data Values for biome IDs. If this tag does not exist it will be created and filled by Minecraft when the chunk is loaded and saved. If any values in this array are -1, Minecraft will also set them to the correct biome.
- HeightMap: 1024 bytes(256 TAG_Int) of heightmap data. 16 × 16. Each byte records the lowest level in each column where the light from the sky is at full strength. Speeds computing of the SkyLight.
- Sections: List of Compound tags, each tag is a sub-chunk of sorts.
- An individual Section.
- Y: The Y index (not coordinate) of this section. Range 0 to 15 (bottom to top), with no duplicates but some sections may be missing if empty.
- Blocks: 4096 bytes of block IDs defining the terrain. 8 bits per block, plus the bits from the below Add tag.
- Add: May not exist. 2048 bytes of additional block ID data. The value to add to (combine with) the above block ID to form the true block ID in the range 0 to 4095. 4 bits per block. Combining is done by shifting this value to the left 8 bits and then adding it to the block ID from above.
- Data: 2048 bytes of block data additionally defining parts of the terrain. 4 bits per block.
- BlockLight: 2048 bytes recording the amount of block-emitted light in each block. Makes load times faster compared to recomputing at load time. 4 bits per block.
- SkyLight: 2048 bytes recording the amount of sunlight or moonlight hitting each block. 4 bits per block.
- An individual Section.
- Entities: Each TAG_Compound in this list defines an entity in the chunk. See Entity Format below. If this list is empty it will be a list of End tags (before 1.10, list of Byte tags).
- TileEntities: Each TAG_Compound in this list defines a block entity in the chunk. See Block Entity Format below. If this list is empty it will be a list of End tags (before 1.10, list of Byte tags).
- TileTicks: May not exist. Each TAG_Compound in this list is an "active" block in this chunk waiting to be updated. These are used to save the state of redstone machines, falling sand or water, and other activity. See Tile Tick Format below. This tag may not exist.
Block format[επεξεργασία | επεξεργασία κώδικα]
In the Anvil format, block positions are ordered YZX for compression purposes.
The coordinate system is as follows:
- X increases East, decreases West
- Y increases upwards, decreases downwards
- Z increases South, decreases North
This also happens to yield the most natural scan direction, because all indices in the least significant dimension (i.e. X in this case) appear for each index in the next most significant dimension; so one reads an array ordered YZX as one would a book lying with its top northward, all letters (or X-indices) on a single line (or Z-index) at a time, and all lines on a single page (or Y-index) at a time. For the 2D arrays (i.e. "Biomes" and "HeightMap") the inapplicable Y dimension is simply omitted, as though the book is only one page thick.
Each section in a chunk is a 16x16x16-block area, with up to 16 sections in a chunk. Section 0 is the bottom section of the chunk, and section 15 is the top section of the chunk. To save space, completely empty sections are not saved. Within each section is a byte tag "Y" for the Y index of the section, 0 to 15, and then byte arrays for the blocks. The "Block" byte array has 4096 partial block IDs at 8 bits per block. Another byte array "Add" is used for block with IDs over 255, and is 2048 bytes of the other part of the 4096 block IDs at 4 bits per block. When both the "Block" and "Add" byte arrays exist, the partial ID from the "Add" array is shifted left 8 bits and added to the partial ID from the "Blocks" array to form the true Block ID. The "Data" byte array is also 2048 bytes for 4096 block data values at 4 bits per block. The "BlockLight" and "SkyLight" byte arrays are the same as the "Data" byte array but they are used for block light levels and sky light levels respectively. The "SkyLight" values represent how much sunlight or moonlight can potentially reach the block, independent of the current light level of the sky.
The endianness of the 2048-byte arrays (i.e. "Add," "Data," "BlockLight," & "SkyLight"), which give only 4 bits per block, seems to stand as the one anomalous exception to the otherwise consistent, format-wide standard of big-endian data storage. It also runs counter to the presumably natural human-readable printing direction. If the blocks begin at 0, they are grouped with even numbers preceding odd numbers (i.e. 0 & 1 share a byte, 2 & 3 share the next, etc.); under these designations Minecraft stores even-numbered blocks in the least significant half-byte, and odd-numbered blocks in the most significant half-byte. Thus block[0] is byte[0] at 0x0F, block[1] is byte[0] at 0xF0, block[2] is byte[1] at 0x0F, block[3] is byte[1] at 0xF0, etc. ...
The pseudo-code below shows how to access individual block information from a single section. Hover over text to see additional information or comments.
byte Nibble4(byte[] arr, int index){ return index%2 == 0 ? arr[index/2]&0x0F : (arr[index/2]>>4)&0x0F; } int BlockPos = y*16*16 + z*16 + x; byte BlockID_a = Blocks[BlockPos]; byte BlockID_b = Nibble4(Add, BlockPos); short BlockID = BlockID_a + (BlockID_b << 8); byte BlockData = Nibble4(Data, BlockPos); byte Blocklight = Nibble4(BlockLight, BlockPos); byte Skylight = Nibble4(SkyLight, BlockPos);
Entity format[επεξεργασία | επεξεργασία κώδικα]
Every entity is an unnamed TAG_Compound contained in the Entities list of a chunk file. The sole exception is the Player entity, stored in level.dat, or in <player>.dat files on servers. All entities share this base:
id Pos Motion Rotation FallDistance Fire Air OnGround Dimension Invulnerable PortalCooldown UUIDMost UUIDLeast UUID CustomName CustomNameVisible Silent Riding CommandStats SuccessCountObjective SuccessCountName AffectedBlocksObjective AffectedBlocksName AffectedEntitiesObjective AffectedEntitiesName AffectedItemsObjective AffectedItemsName QueryResultObjective QueryResultName
- Entity data
Mobs[επεξεργασία | επεξεργασία κώδικα]
Mob Entities | |
---|---|
Entity ID | Name |
bat | Bat |
blaze | Blaze |
cave_spider | Cave Spider |
chicken | Chicken |
cow | Cow |
creeper | Creeper |
donkey | Donkey |
elder_guardian | Elder Guardian |
ender_dragon | Ender Dragon |
enderman | Enderman |
endermite | Endermite |
evocation_illager | Evoker |
ghast | Ghast |
giant | Giant |
guardian | Guardian |
horse | Horse |
husk | Husk |
llama | Llama |
magma_cube | Magma Cube |
mooshroom | Mooshroom |
mule | Mule |
ocelot | Ocelot |
pig | Pig |
polar_bear | Polar Bear |
rabbit | Rabbit |
sheep | Sheep |
shulker | Shulker |
silverfish | Silverfish |
skeleton | Skeleton |
skeleton_horse | Skeleton Horse |
slime | Slime |
snowman | Snow Golem |
spider | Spider |
squid | Squid |
stray | Stray |
vex | Vex |
villager | Villager |
villager_golem | Iron Golem |
vindication_illager | Vindicator |
witch | Witch |
wither | Wither |
wither_skeleton | Wither Skeleton |
wolf | Wolf |
zombie | Zombie |
zombie_horse | Zombie Horse |
zombie_pigman | Zombie Pigman |
zombie_villager | Zombie Villager |
Mobs are a subclass of Entity with additional tags to store their health, attacking/damaged state, potion effects, and more depending on the mob. Players are a subclass of Mob.
- Entity data
- Tags common to all entities 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
- 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
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- 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.
- 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.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/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
- powered: 1 or 0 (true/false) - May not exist. True if the creeper is charged from being struck by lightning.
- 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 will return 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 a Flint and Steel.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Bred: 1 or 0 (true/false) - Unknown. Remains 0 after breeding. If true, causes it to stay near other horses with this flag set.
- EatingHaystack: 1 or 0 (true/false) - true if the horse is grazing.
- Tame: 1 or 0 (true/false) - true if the horse is tamed. (Non players mobs will not be able to ride a tamed horse if it has no saddle)
- Temper: Ranges from 0 to 100; increases with feeding. Higher values make a horse easier to tame.
- OwnerUUID: Contains the UUID of the player that tamed the horse. Has no effect on behavior.
- ArmorItem: The armor item worn by this horse. May not exist.
- Tags common to all items see Template:Nbt inherit/item/template
- SaddleItem: The saddle item worn by this horse. May not exist.
- Tags common to all items see Template:Nbt inherit/item/template
- ChestedHorse: 1 or 0 (true/false) - true if the horse has chests. A chested horse that is not a donkey or a mule will crash 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
- 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
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- carried: ID of the block carried by the enderman. When not carrying anything, 0. When loading, may also be a string block name.
- carriedData: Additional data about the block carried by the enderman. 0 when not carrying anything.
- 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: Endermen will attack the endermite if this 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
- SpellTicks: Number of ticks until a channeled spell is cast. 0 when not casting, positive when casting. Decreases by 1 per tick.
- 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 this ghast fires. Default value of 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
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Bred: 1 or 0 (true/false) - Unknown. Remains 0 after breeding. If true, causes it to stay near other horses with this flag set.
- EatingHaystack: 1 or 0 (true/false) - true if the horse is grazing.
- Tame: 1 or 0 (true/false) - true if the horse is tamed. (Non players mobs will not be able to ride a tamed horse if it has no saddle)
- Temper: Ranges from 0 to 100; increases with feeding. Higher values make a horse easier to tame.
- OwnerUUID: Contains the UUID of the player that tamed the horse. Has no effect on behavior.
- ArmorItem: The armor item worn by this horse. May not exist.
- Tags common to all items see Template:Nbt inherit/item/template
- SaddleItem: The saddle item worn by this horse. May not exist.
- Tags common to all items see Template:Nbt inherit/item/template
- Variant: The variant of the horse. Determines colors. Stored as
baseColor | markings << 8
. Unused values lead to invisible 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
- IsBaby: 1 or 0 (true/false) - true if this zombie is a baby. May be absent.
- CanBreakDoors: 1 or 0 (true/false) - true if the zombie can break doors (default value 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
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/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.
- EatingHaystack: 1 or 0 (true/false) - true if grazing.
- Tame: 1 or 0 (true/false) - true if the llama is tamed. (Non players mobs will not be able to ride a tamed llama if it has no saddle)
- Temper: Ranges from 0 to 100; increases with feeding. Higher values make a llama easier to tame.
- 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 will cause a wolf to always run away.
- 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
- OwnerUUID: Contains the UUID of the player that tamed the llama. Has no effect on behavior.
- Items: List of items. Only exists 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.
- 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 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
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/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
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Bred: 1 or 0 (true/false) - Unknown. Remains 0 after breeding. If true, causes it to stay near other horses with this flag set.
- EatingHaystack: 1 or 0 (true/false) - true if the horse is grazing.
- Tame: 1 or 0 (true/false) - true if the horse is tamed. (Non players mobs will not be able to ride a tamed horse if it has no saddle)
- Temper: Ranges from 0 to 100; increases with feeding. Higher values make a horse easier to tame.
- OwnerUUID: Contains the UUID of the player that tamed the horse. Has no effect on behavior.
- ArmorItem: The armor item worn by this horse. May not exist.
- Tags common to all items see Template:Nbt inherit/item/template
- SaddleItem: The saddle item worn by this horse. May not exist.
- Tags common to all items see Template:Nbt inherit/item/template
- ChestedHorse: 1 or 0 (true/false) - true if the horse has chests. A chested horse that is not a donkey or a mule will crash 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
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Additional fields for mobs that can be tamed by players see Template:Nbt inherit/tameable/template
- CatType: The ID of the skin the ocelot has. 0 = wild ocelot, 1 = tuxedo, 2 = tabby, 3 = siamese. Does not determine an ocelot's behavior: it will be wild unless its Owner string is not empty, meaning wild ocelots can look like cats and vice versa.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/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
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- RabbitType: Determines the skin of the rabbit. Also determines if rabbit should be hostile. 0 = Brown, 1 = White, 2 = Black, 3 = Black & White, 4 = Gold, 5 = Salt & Pepper, 99 = Killer Bunny.
- 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.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Sheared: 1 or 0 (true/false) - true if the sheep has been shorn.
- Color: 0 to 15 - see wool data values for a mapping to colors.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Peek: Height of the head of the shulker.
- AttachFace: Direction of the block the shulker is attached to.
- Color: Data value of the color of the shulker. Default is 0 (white). Shulkers spawned by eggs or as part of End cities have value 10 (purple).
- APX: Approximate X coordinate.
- APY: Approximate Y coordinate.
- APZ: Approximate Z coordinate.
- 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
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Bred: 1 or 0 (true/false) - Unknown. Remains 0 after breeding. If true, causes it to stay near other horses with this flag set.
- EatingHaystack: 1 or 0 (true/false) - true if the horse is grazing.
- Tame: 1 or 0 (true/false) - true if the horse is tamed. (Non players mobs will not be able to ride a tamed horse if it has no saddle)
- Temper: Ranges from 0 to 100; increases with feeding. Higher values make a horse easier to tame.
- OwnerUUID: Contains the UUID of the player that tamed the horse. Has no effect on behavior.
- ArmorItem: The armor item worn by this horse. May not exist.
- Tags common to all items see Template:Nbt inherit/item/template
- SaddleItem: The saddle item worn by this horse. May not exist.
- Tags common to all items see Template:Nbt inherit/item/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 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 it has a pumpkin on its head or not.
- 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
- 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
- BoundX: Unknown. May stop it from wandering too far?
- BoundY: Unknown. May stop it from wandering too far?
- BoundZ: Unknown. May stop it from wandering too far?
- LifeTicks: Ticks of life remaining, decreasing by 1 per tick. When it reaches zero, the Vex will take damage and
LifeTicks
is set to 20.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Profession: The ID of the texture used for this villager. This also influences trading options.
- Riches: Currently unused. Increases by the number of emeralds traded to a villager any time they are traded.
- Career: The ID of this villager's career. This also influences trading options and the villager's name in the GUI (if it does not have a CustomName). If 0, the next time offers are refreshed, the game will assign a new Career and reset CareerLevel to 1.
- CareerLevel: The current level of this villager's trading options. Influences the trading options generated by the villager; if it is greater than their career's maximum level, no new offers are generated. Increments when a trade causes offers to be refreshed. If 0, the next trade to do this will assign a new Career and set CareerLevel to 1. Set to a high enough level and there will be no new trades to release (Career must be set to 1 or above).
- Willing: 1 or 0 (true/false) - true if the villager is willing to mate. Becomes true after certain trades (those which would cause offers to be refreshed), and false after mating.
- 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 will automatically be condensed into one slot. If there are more than 8 slots, the last slot will be removed until the total is 8. If there are 9 slots but two previous slots can be condensed, the last slot will be present 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.
- Offers: Is generated when the trading menu is opened for the first time.
- Recipes: List of trade options.
- A trade option.
- rewardExp: 1 or 0 (true/false) - true if this trade will provide XP orb drops.
- 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.
- 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.
- 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
- 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
- A trade option.
- Recipes: List of trade options.
- Entity data
- 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) - true if this golem was created by a player. If true, the golem will never attack the player.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Johnny: Optional. 1 or 0 (true/false) - Setting to true will cause the vindicator to exhibit Johnny behavior. Setting to false will prevent the vindicator exhibiting Johnny behavior, even if named Johnny.
- 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
- 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
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Additional fields for mobs that can be tamed by players see Template:Nbt inherit/tameable/template
- Angry: 1 or 0 (true/false) - true if the wolf is angry.
- CollarColor: The dye color of this 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 this zombie is a baby. May be absent.
- CanBreakDoors: 1 or 0 (true/false) - true if the zombie can break doors (default value 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
- Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
- Bred: 1 or 0 (true/false) - Unknown. Remains 0 after breeding. If true, causes it to stay near other horses with this flag set.
- EatingHaystack: 1 or 0 (true/false) - true if the horse is grazing.
- Tame: 1 or 0 (true/false) - true if the horse is tamed. (Non players mobs will not be able to ride a tamed horse if it has no saddle)
- Temper: Ranges from 0 to 100; increases with feeding. Higher values make a horse easier to tame.
- OwnerUUID: Contains the UUID of the player that tamed the horse. Has no effect on behavior.
- ArmorItem: The armor item worn by this horse. May not exist.
- Tags common to all items see Template:Nbt inherit/item/template
- SaddleItem: The saddle item worn by this horse. May not exist.
- Tags common to all items see Template:Nbt inherit/item/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
- IsBaby: 1 or 0 (true/false) - true if this zombie is a baby. May be absent.
- CanBreakDoors: 1 or 0 (true/false) - true if the zombie can break doors (default value is 0).
- Anger: Ticks until the zombie pigman becomes neutral. -32,768 to 0 for neutral zombie pigmen; 1 to 32,767 for angry zombie pigmen. Value depletes by one every tick if value is greater than 0. When the value turns from 1 to 0, the zombie pigman does not stop tracking the player until the player has exited the zombie pigman's detection radius. When hit by a player or when another zombie pigman within 32 blocks is hit by a player, the value is set to a random number between 400 and 800.
- HurtBy: The UUID of the last player that attacked the zombie pigman.
- 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 this zombie is a baby. May be absent.
- CanBreakDoors: 1 or 0 (true/false) - true if the zombie can break doors (default value is 0).
- Profession: 0: farmer, 1: librarian, 2: priest, 3: blacksmith, 4: butcher, 5: nitwit (default value is 0).
- 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 will parallel this.
Projectiles[επεξεργασία | επεξεργασία κώδικα]
Projectile Entities | |
---|---|
Entity ID | Name |
arrow | Arrow |
dragon_fireball | Ender Dragon Fireball |
egg | Egg |
ender_pearl | Ender Pearl |
fireball | Ghast Fireball |
potion | Splash Potion |
small_fireball | Blaze Fireball/Fire Charge |
snowball | Snowball |
spectral_arrow | Spectral Arrow |
wither_skull | Wither Skull |
xp_bottle | Bottle o' Enchanting |
Projectiles are a subclass of Entity and have very obscure tags such as X,Y,Z coordinate tags despite Entity Pos tag, inTile despite inGround, and shake despite most projectiles not being arrows. While all projectiles share tags, they are all independently implemented through Throwable
and ArrowBase
.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all projectiles see Template:Nbt inherit/projectile/template
Chunk format/ShakyProjectile
Chunk format/Arrow
An Arrow
entity is a tipped arrow if it has either the Potion
or CustomPotionEffects
tag. The tipped_arrow
item uses these tags, but the arrow
item does not.
- Entity/item data
- Color (since 16w50a): 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 produce white. - Player.dat format/Potion
- Color (since 16w50a): Used by the arrow entity, for displaying the custom potion color of a fired arrow item that had a
- 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 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
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- ExplosionPower: The power and size of the explosion created by the fireball upon impact. Default value 1.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all projectiles see Template:Nbt inherit/projectile/template
Chunk format/ShakyProjectile Chunk format/OwnerProjectile
- Potion: The item that was thrown. The ThrownPotion entity will render as this stored item, no matter the item.
- Tags common to all potion items see Template:Nbt inherit/itempotion/template
-
potionValue(deprecated): If the Potion tag does not exist, this value is used as the damage value of the thrown potion.
- Potion: The item that was thrown. The ThrownPotion entity will render as this stored item, no matter the item.
- 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 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
Chunk format/ShakyProjectile Chunk format/Arrow
- Duration: The time in ticks that the Glowing effect will last.
- 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 projectiles see Template:Nbt inherit/projectile/template
Items and XPOrbs[επεξεργασία | επεξεργασία κώδικα]
Item Entities | |
---|---|
Entity ID | Name |
item | Dropped Item |
xp_orb | Experience Orb |
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 item has been "untouched". After 6000 ticks (5 minutes) the item is destroyed. If set to -32768, the Age will not increase, thus the item will not automatically despawn.
- Health: The health of the item, which starts at 5. Items take damage from fire, lava, falling anvils, and explosions. The item is destroyed when its health reaches 0.
- PickupDelay: The number of ticks the item cannot be picked up. Decreases by 1 per tick. If set to 32767, the PickupDelay will not decrease, thus the item can never be picked up.
- Owner: If not an empty string, only the named player will be able to pick up this item, until it is within 10 seconds of despawning. 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.
- Thrower: Set to the name of the player who dropped the item, if dropped by a player. Used by the "Diamonds to you!" achievement.
- Item: The inventory item, without the Slot tag.
- Tags common to all items see Template:Nbt inherit/item/template
- 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. If set to -32768, the Age will not increase, thus the XP orb will not automatically despawn.
- 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 will overflow.
- Value: The amount of experience the orb gives when picked up.
Vehicles[επεξεργασία | επεξεργασία κώδικα]
Vehicle Entities | |
---|---|
Entity ID | Name |
boat | Boat |
Minecart Minecart with Chest Minecart with Furnace | |
minecart | Minecart |
chest_minecart | Minecart with Chest |
commandblock_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. 0 or omitted will use a random seed.[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.
- 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.
- 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.
- TrackOutput: 1 or 0 (true/false) - Determines whether or not the LastOutput will be 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
- PushX: Force along X axis, used for smooth acceleration/deceleration.
- PushZ: Force along Z axis, used for smooth acceleration/deceleration.
- Fuel: The number of ticks until the minecart runs out of fuel.
- 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 4.
- Tags common to all items see Template:Nbt inherit/item/template
- An item, including the Slot tag. Slots are numbered 0 to 4.
- TransferCooldown: Time until the next transfer in game ticks, between 1 and 8, or 0 if there is no transfer.
- Enabled: Determines whether or not the minecart hopper will pick up items into its inventory.
- 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 will use a random seed.[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
- 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[επεξεργασία | επεξεργασία κώδικα]
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
- Fuse: Ticks until explosion. Default is 0. If activated from a TNT block, fuse value will be 80 (4 seconds).
Other[επεξεργασία | επεξεργασία κώδικα]
Other Entities | |
---|---|
Entity ID | Name |
area_effect_cloud | Area Effect Cloud |
armor_stand | Armor Stand |
ender_crystal | End Crystal |
evocation_fangs | Evocation Fangs |
eye_of_ender_signal | Eye of Ender |
fireworks_rocket | Firework Rocket |
item_frame | Item Frame |
leash_knot | Lead Knot |
llama_spit | Llama spit |
painting | Painting |
shulker_bullet | Shulker Bullet |
Fishing Rod Bobber |
Other entity types that are a subclass of Entity but do not fit into any of the above categories.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Age: Age of the field.
- Color: The color of the displayed particle. Uses the same format as the color tag from Display Properties.
- Duration: Maximum age of the field. Field dissipates at this age, regardless of radius.
- ReapplicationDelay: The number of ticks before reapplying the effect.
- WaitTime: The time before deploying the field. Doesn't apply Potion Effect until it hits the Age number.
- OwnerUUIDMost: UUIDMost of the owner.
- OwnerUUIDLeast: UUIDLeast of the owner.
- DurationOnUse: Unknown. Does not appear to effect age or duration.
- Radius: The area's radius
- RadiusOnUse: The amount the radius grows upon applying the effect. Normally negative
- RadiusPerTick: The amount the radius grows per tick. Normally negative
- Particle: The particle displayed by the area effect.
- ParticleParam1: For
blockdust
,blockcrack
andfallingdust
particles, specifies a numeric block id and a data value, using a single number: id+(data×4096). Foriconcrack
, specifies a numeric block id or item id. - ParticleParam2: For
iconcrack
, specifies a data value. - Potion: The name of the default potion effect. See potion data values for valid IDs.
- Effects A list of the applied effects.
- An individual effect.
- Ambient: Reduced particle display
- Amplifier: potion level.
- Id: Potion id
- ShowParticles: particle display
- Duration: effect duration. 0 if instant.
- An individual effect.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- DisabledSlots: Bit field allowing disable place/replace/remove of armor elements. 1 << slot = disables all interaction, 1 << (slot + 8) = disables removing and 1 << (slot + 16) = disables placing.
-
Equipment(deprecated since 1.9): The list of compound tags of the equipment the stand has. Each compound tag in the list is an Item without the slot tag. All 5 entries will always exist but may be empty compound tags to indicate no item.- 0: The item being held in the entity's hand.
- 1: Armor (feet)
- 2: Armor (legs)
- 3: Armor (chest)
- 4: Armor (head)
- HandItems: The list of items the stand is holding in its hands. Each compound tag in the list is an Item without the slot tag. Both entries will always exist but may be empty compound tags to indicate no item.
- 0: The item in the stand's main hand.
- 1: The item in the stand's off hand.
- ArmorItems: The list of items the stand is wearing as armor. Each compound tag in the list is an Item without the slot tag. All 4 entries will always exist but may be empty compound tags to indicate no item.
- 0: Boots slot
- 1: Legs slot
- 2: Chest slot
- 3: Head slot
- Marker: 1 or 0 (true/false) - if true, ArmorStand's size will be set to 0, have a tiny hitbox and disable interactions with it. May not exist.
- Invisible: 1 or 0 (true/false) - if true, ArmorStand will be invisible, although items on it will display.
- NoBasePlate: 1 or 0 (true/false) - if true, ArmorStand will not display the base beneath it.
- FallFlying: When set to 1 for non-player entities, will cause the entity to glide as long as they are wearing elytra in the chest slot. Can be used to detect when the player is gliding without using scoreboard statistics.
- Pose: Rotation values for the ArmorStand's pose.
- Body: Body-specific rotations.
- : x-rotation.
- : y-rotation.
- : z-rotation.
- LeftArm: Left Arm-specific rotations.
- : x-rotation.
- : y-rotation.
- : z-rotation.
- RightArm: Right Arm-specific rotations.
- : x-rotation.
- : y-rotation.
- : z-rotation.
- LeftLeg: Left Leg-specific rotations.
- : x-rotation.
- : y-rotation.
- : z-rotation.
- RightLeg: Right Leg-specific rotations.
- : x-rotation.
- : y-rotation.
- : z-rotation.
- Head: Head-specific rotations.
- : x-rotation.
- : y-rotation.
- : z-rotation.
- Body: Body-specific rotations.
- ShowArms: 1 or 0 (true/false) - if true, ArmorStand will display 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 will be much smaller, similar to the size of a baby zombie.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- 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, and will reach -20 on naturally spawned fangs.
- Owner: Contains information about the entity who owns the evocation fangs.
- OwnerUUIDMost: UUIDMost of the owner.
- OwnerUUIDLeast: UUIDLeast of the owner.
- 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
- 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))
- FireworksItem: The crafted Firework Rocket item.
- tag: The tag tag.
- Explosion: One of these may appear on a firework star.
- Flicker: 1 or 0 (true/false) - true if this explosion will have the Twinkle effect (glowstone dust). May be absent.
- Trail: 1 or 0 (true/false) - true if this explosion will have 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 will be named "Unknown Shape" and render as Small Ball.
- Colors: Array of integer values corresponding to the primary colors of this firework's explosion. If custom color codes are used, the game will render it as "Custom" in the tooltip, but the proper color will be 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.
- Fireworks: One of these may appear on a firework rocket.
- 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 will cause.
- Same format as 'Explosion' compound on a firework star, as described above.
- Explosion: One of these may appear on a firework star.
- tag: The tag tag.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- 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/item/template
- ItemDropChance: The chance the item will drop when the item frame breaks. 1.0 by default.
- ItemRotation: The number of times the item has been rotated 45 degrees clockwise.
- Item: The item, without the slot tag. If the item frame is empty, this tag does not exist.
- 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
- Owner: Contains information about the entity who owns the spit.
- OwnerUUIDMost: UUIDMost of the owner.
- OwnerUUIDLeast: UUIDLeast of the owner.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Motive: The name of the painting's artwork.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Owner: The owner of this ShulkerBullet.
- L: UUIDLeast of the owner.
- M: UUIDMost of the owner.
- X: X block coordinate of the owner.
- Y: Y block coordinate of the owner.
- Z: Z block coordinate of the owner.
- 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 will instead use TXD/TYD/TZD in a straight line (similar to fireballs).
- Target: The target of this ShulkerBullet.
- L: UUIDLeast of the target.
- M: UUIDMost of the target.
- X: X block coordinate of the target.
- Y: Y block coordinate of the target.
- Z: Z block coordinate of the target.
- TXD: The offset in the X direction to travel in accordance with its target.
- TYD: The offset in the Y direction to travel in accordance with its target.
- TZD: The offset in the Z direction to travel in accordance with its target.
Block entity format[επεξεργασία | επεξεργασία κώδικα]
Block Entities | |
---|---|
Block Entity ID | Associated Block |
banner | Banner |
beacon | Beacon |
brewing_stand | Brewing Stand |
cauldron (PE) | Cauldron |
chest | Chest Trapped Chest |
comparator | Redstone Comparator |
command_block | Command Block |
daylight_detector | Daylight Sensor |
dispenser | Dispenser |
dropper | Dropper |
enchanting_table | Enchantment Table |
ender_chest | Ender Chest |
end_gateway | End Gateway (block) |
end_portal | End Portal (block) |
flower_pot | Flower Pot |
furnace | Furnace |
hopper | Hopper |
jukebox | Jukebox |
mob_spawner | Monster Spawner |
noteblock | Note Block |
piston | Piston Moving |
sign | Sign |
skull | Mob head |
structure_block | Structure Block |
A block entity (not related to entity) is used by Minecraft to store information about a block that can't be stored in the four bits of block data the block has. Block entities were called "tile entities" until the 1.8 snapshots and that term is still used in some command usage.
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- Base: Determines background color of the banner.
- Patterns: List of all patterns applied to the banner.
- : An individual pattern.
- Color: Color of the section.
- Pattern: Section of the banner the color is applied to (see Banner/Patterns).
- : An individual pattern.
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- 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
- CustomName: Optional. The name of this container, which will display in its GUI where the default name ordinarily is.
- Lock: Optional. When not blank, prevents the container from being opened unless the opener is holding an item whose name matches this string.
- Items: List of items in the 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.
- 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 will 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
- CustomName: Optional. The name will replace the usual '@' when using commands such as
/say
and/tell
. - CommandStats: Information identifying scoreboard parameters to modify relative to the last command run.
- SuccessCountName: Player name to store success of the last command. Can be a player selector but may only have one resulting target.
- SuccessCountObjective: Objective's name to store the success of the last command.
- AffectedBlocksName: Player name to store how many blocks were modified in the last command. Can be a player selector but may only have one resulting target.
- AffectedBlocksObjective: Objective's name to store how many blocks were modified in the last command.
- AffectedEntitiesName: Player name to store how many entities were altered in the last command. Can be a player selector but may only have one resulting target.
- AffectedEntitiesObjective: Objective's name to store how many entities were altered in the last command.
- AffectedItemsName: Player name to store how many items were altered in the last command. Can be a player selector but may only have one resulting target.
- AffectedItemsObjective: Objective's name to store how many items were altered in the last command.
- QueryResultName: Player name to store the query result of the last command. Can be a player selector but may only have one resulting target.
- QueryResultObjective: Objective's name to store the query result of the last command.
- Command: The command to issue to the server.
- 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.
- 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.
- TrackOutput: 1 or 0 (true/false) - Determines whether or not the LastOutput will be 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.
- powered: 1 or 0 (true/false) - States whether or not the command block is powered by redstone or not.
- auto: 1 or 0 (true/false) - Allows to activate the command without the requirement of a redstone signal.
- 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.
- 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, which will display in its GUI where the default name ordinarily is.
- Lock: Optional. When not blank, prevents the container from being opened unless the opener is holding an item whose name matches this string.
- Items: List of items in the 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.
- 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 will use 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, which will display in its GUI where the default name ordinarily is.
- Lock: Optional. When not blank, prevents the container from being opened unless the opener is holding an item whose name matches this string.
- Items: List of items in the 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.
- 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 will use 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, which will display in its GUI where the default name ordinarily is.
- Lock: Optional. When not blank, prevents the container from being opened unless the opener is holding an item whose name matches this string.
- Items: List of items in the container.
- : An item, including the slot tag.
- Tags common to all items see Template:Nbt inherit/item/template
- : An item, including the slot tag.
- TransferCooldown: Time until the next transfer in game ticks, naturally between 1 and 8 or 0 if there is no transfer.
- 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 will use a random seed.[note 1]
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- note: Pitch (number of uses).
- powered: 1 or 0 (true/false) - if true, the noteblock is being provided a redstone signal.
- Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- blockId: Block IDs of the block being moved.
- blockData: Data value of the block being moved.
- facing: Direction in which the block will be pushed. (0=down, 1=up, 2=north, 3=south, 4=west, 5=east)
- progress: How far the block has been moved.
- extending: 1 or 0 (true/false) - true if the block is being pushed.
- 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
- name: Name of the structure.
- author: Author of the structure; only set to "?" for normal structures
- metadata: Custom data for the structure
- posX: X-position of the structure
- posY: Y-position of the structure
- posZ: Z-position of the structure
- sizeX: X-size of the structure, its length
- sizeY: Y-size of the structure, its height
- sizeZ: Z-size of the structure, its depth
- rotation: Rotation of the structure, one of "NONE", "CLOCKWISE_90", "CLOCKWISE_180", or "COUNTERCLOCKWISE_90"
- mirror: How the structure is mirrored, one of "NONE", "LEFT_RIGHT", or "FRONT_BACK"
- mode: The current mode of this structure block, one of "SAVE", "LOAD", "CORNER", or "DATA"
- ignoreEntities: 1 or 0 (true/false): Whether entities should be ignored in the structure
Tile tick format[επεξεργασία | επεξεργασία κώδικα]
Tile Ticks represent block updates that need to happen because they could not happen before the chunk was saved. Examples reasons for tile ticks include redstone circuits needing to continue updating, water and lava that should continue flowing, recently placed sand or gravel that should fall, etc. Tile ticks are not used for purposes such as leaf decay, where the decay information is stored in the leaf block data values and handled by Minecraft when the chunk loads. For map makers, tile ticks can be used to update blocks after a period of time has passed with the chunk loaded into memory.
- A Tile Tick
- i: The ID of the block; used to activate the correct block update procedure.
- t: The number of ticks until processing should occur. May be negative when processing is overdue.
- p: If multiple tile ticks are scheduled for the same tick, tile ticks with lower p will be processed first. If they also have the same p, the order is unknown.
- x: X position
- y: Y position
- z: Z position
History[επεξεργασία | επεξεργασία κώδικα]
Chunks were first introduced in Minecraft Infdev. Before the addition of the MCRegion format in Beta 1.3, chunks were stored as individual chunk files ".dat" where the file names contained the chunk's position encoded in Base36 - this is known as the Alpha level format. MCRegion changed this by storing groups of 32×32 chunks in individual ".mcr" files with the coordinates in Base10, with the goal being to reduce disk usage by cutting down on the number of file handles Minecraft had open at once. MCRegion's successor is the current format, Anvil, which only made changes to the chunk format. The region file technique is still used, but the region file extensions are ".mca" instead.
The major change from MCRegion to Anvil was the division of Chunks into Sections; each chunk has up to 16 individual 16×16×16 block Sections so that completely empty sections will not be saved at all. Preparation has also been made to support blocks with IDs in the range 0 to 4095, as compared to the previous 0 to 255 limitation. However, Minecraft is not fully prepared for such blocks to exist as items; many item IDs are already taken in the range 256 to 4095.
The Blocks, Data, BlockLight, and SkyLight arrays are now housed in individual chunk Sections. The Data, SkyLight, and BlockLight are arrays of 4-bit values, and the BlockLight and SkyLight arrays no longer house part of the block ID. The Blocks array is 8 bits per block, and the 4096-blocks support exists in the form of an optional Add byte array of 4-bits per block for additional block ID information. With the Anvil format, the NBT Format was changed from Notch's original specification to include an integer array tag similar to the existing byte array tag. It is currently only used for HeightMap information in chunks.
Official release | ||||
---|---|---|---|---|
? | Removed MaxExperience , RemainingExperience , ExperienceRegenTick , ExperienceRegenRate and ExperienceRegenAmount from MobSpawner . | |||
1.4.2 | 12w34a | Added entity WitherBoss . | ||
1.5 | 13w02a | Added entity MinecartTNT .
| ||
Minecart is now deprecated. | ||||
13w03a | Added entity MinecartHopper . | |||
13w06a | Added entity MinecartSpawner . | |||
1.6.1 | 13w16a | Added entity EntityHorse . | ||
13w21a | Removed ArmorType from EntityHorse .
| |||
Removed Saddle from EntityHorse . | ||||
1.6.1-pre | Readded Saddle to EntityHorse . | |||
1.7.2 | 13w39a | Added entity MinecartCommandBlock . | ||
1.8 | 14w02a | Added Lock to containers.
| ||
Item IDs are no longer used when specifying NBT data. | ||||
Added Block to FallingSand , using the alphabetical ID format. | ||||
14w06a | Added ShowParticles to all mobs.
| |||
Added PickupDelay to item entities.
| ||||
Setting Age to -32768 makes items which never expire.
| ||||
Removed AttackTime from mobs. | ||||
14w10a | Added rewardExp to Villager .
| |||
Added OwnerUUID for mobs that can breed.
| ||||
Added Owner to Skull .
| ||||
Changes to item frames and paintings: added Facing , TileX , TileY and TileZ now represent the co-ordinates of the block the item is in rather than what it is placed on, deprecated Direction and Dir . | ||||
14w11a | Added entity Endermite .
| |||
Added EndermiteCount to Enderman . | ||||
14w21a | CustomName and CustomNameVisible now work for all entities. | |||
14w25a | Added entity Guardian .
| |||
Added Text1 , Text2 , Text3 and Text4 to signs. The limit no longer depends on the amount of characters (16), it now depends on the width of the characters. | ||||
14w27a | Added entity Rabbit .
Added CommandStats to command blocks and signs. | |||
14w28a | Removed EndermiteCount from Enderman . | |||
14w30a | Added Silent for all entities. | |||
14w32a | Added NoAI for all mobs.
| |||
Added entity ArmorStand . | ||||
14w32c | Added NoBasePlate to ArmorStand . | |||
1.9 | 15w31a | Added tags HandItems , ArmorItems , HandDropChances , and ArmorDropChances to Living , which replace the DropChances and Equipment tags.
| ||
Added HandItems and ArmorItems to ArmorStand .
| ||||
Added Glowing to Entity .
| ||||
Added Team to LivingBase .
| ||||
Added DragonPhase to EnderDragon
| ||||
Added entity Shulker , child of Entity .
| ||||
Added entity ShulkerBullet , child of Entity .
| ||||
Added entity DragonFireball , which extends FireballBase and has no unique tags.
| ||||
Added entities TippedArrow and SpectralArrow , children of Arrow .
| ||||
Added block EndGateway , child of TileEntity .
| ||||
15w32a | Tags and DataVersion tag can now be applied on entities.
| |||
Changed the Fuse tag's type for the PrimedTnt entity from "Byte" to "Short". | ||||
15w32c | Introduced a limit on the amount of tags an entity can have (1024 tags). When surpassed it displays an error saying: "Cannot add more than 1024 tags to an entity." | |||
15w33a | Added entity AreaEffectCloud , child of Entity .
| |||
Added ExactTeleport and renamed Life to Age for EndGateway .
| ||||
Added Linger to ThrownPotion .
| ||||
Removed DataVersion from Entity . It is now only applied to Player only, child of LivingBase .
| ||||
Removed UUID from Entity .
| ||||
HealF under LivingBase has become deprecated.
| ||||
Health under LivingBase has changed from type "Short" to "Float".
| ||||
Equipment removed from ArmorStand and Living entity, its usage replaced by HandItems and ArmorItems which were added earlier. | ||||
15w33c | Added BeamTarget to EnderCrystal . | |||
15w34a | Added powered and conditional byte tags to Control tile entity for command blocks.
| |||
Added life and power to FireballBase .
| ||||
Added id inside SpawnData to MobSpawner .
| ||||
Added powered to the Music tile entity for note blocks. | ||||
15w35a | Added VillagerProfession to Zombie . | |||
15w37a | Added Enabled to MinecartHopper . | |||
15w38a | Added SkeletonTrap and SkeletonTrapTime to EntityHorse . | |||
15w41a | Replaced Riding with Passengers for all entities.
| |||
Added RootVehicle for all passengers.
| ||||
Added Type to Boat . | ||||
15w42a | Added Fuel to Cauldron (brewing stands). | |||
15w43a | Added LootTable and LootTableSeed to Chest , Minecart and MinecartHopper .
| |||
Added DeathLootTable and DeathLootTableSeed to all mobs.
| ||||
Added life and power to all fireballs (FireballBase ). | ||||
15w44a | Added ShowBottom to EnderCrystal . | |||
15w44b | Added Potion and CustomPotionEffects to Arrow .
| |||
Added Potion to AreaEffectCloud . | ||||
15w45a | Removed Linger from ThrownPotion . Instead, the potion will linger if the stored item has an ID of minecraft:lingering_potion .
| |||
ThrownPotion will now render as its stored item even if the item is not a potion. | ||||
15w46a | MoreCarrotTicks from Rabbit is now set to 40 when rabbits eat a carrot crop, but is not used anyway. | |||
15w47a | Added PaymentItem to Beacon . | |||
15w49a | Removed PaymentItem from Beacon .
| |||
In order for a sign to accept text, all 4 tags ("Text1", "Text2", "Text3", and "Text4") must exist. | ||||
15w51b | The original values of DisabledSlots in ArmorStand have changed in nature. | |||
1.10 | 16w20a | Added entity PolarBear .
| ||
Added ZombieType to Zombie , replacing VillagerProfession and IsVillager . Value of 6 indicates the "husk" zombie.
| ||||
A value of 2 on SkeletonType indicates the "stray" skeleton.
| ||||
NoGravity extended to all entities.
| ||||
Added powered , showboundingbox and showair to Structure . | ||||
16w21a | Added FallFlying to mobs and armor stands.
| |||
Added integrity and seed to Structure . | ||||
1.10-pre1 | Added ParticleParam1 and ParticleParam2 to AreaEffectCloud . | |||
1.11 | 16w32a | Horse was 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 .
| ||
Skeleton was split into entity IDs skeleton , stray and wither_skeleton . SkeletonType tag is removed from all skeleton types.
| ||||
Zombie was 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 .
| ||||
Guardian was split into entity IDs guardian and elder_guardian . Elder tag is removed from guardian .
| ||||
Unused savegame IDs Mob and Monster were removed.
| ||||
Pumpkin byte tag is 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 | Removed xTile , yTile , zTile , inTile , inGround from the fishing bobber entity. | |||
1.11-pre1 | Changed ench to require at least one compound. |
Development cycle |
| ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Help | |||||||||||
Technical |
| ||||||||||
Multiplayer | |||||||||||
Game customization | |||||||||||
Versions | |||||||||||
Merchandise | |||||||||||
Books | |||||||||||
Films |