{{Update|missing information about 1.18 formats, this page is W.I.P. and sections that are updated for 1.18 mention it.}} {{for|the storage format of entities|Entity format}} [[Chunk]]s store the terrain and entities within a 16×384×16 area in The [[Overworld]], and 16×256×16 in [[The Nether]] and [[The End]] by default. They also store precomputed lighting, heightmap data for Minecraft's performance, and other meta information. == NBT structure == {{See also|Region file format|Anvil file format}} Chunks are stored as tags in regional Minecraft Anvil files, which are named in the form {{code|r.x.z.mca}}. They are stored in [[NBT format]], with the following structure (updated for 1.18):
* {{nbt|compound}} The root tag. **{{nbt|int|DataVersion}}: Version of the chunk NBT structure. **{{nbt|int|xPos}}: X position of the chunk (in absolute chunks from world {{cd|x|z|d=,}} origin, '''not''' relative to the region). **{{nbt|int|zPos}}: Z position of the chunk (in absolute chunks from world {{cd|x|z|d=,}} origin, '''not''' relative to the region). **{{nbt|int|yPos}}: Lowest Y section position in the chunk (e.g. {{cd|-4}} in 1.18). **{{nbt|string|Status}}: Defines the world generation status of this chunk. It is always one of the following: {{code|minecraft:empty}}, {{code|minecraft:structure_starts}}, {{code|minecraft:structure_references}}, {{code|minecraft:biomes}}, {{code|minecraft:noise}}, {{code|minecraft:surface}}, {{code|minecraft:carvers}}, {{code|minecraft:features}}, {{code|minecraft:light}}, {{code|minecraft:spawn}}, or {{code|minecraft:full}}. All status except {{code|minecraft:full}} are used for chunks called ''proto-chunks'', in other words, for chunks with incomplete generation. **{{nbt|long|LastUpdate}}: Tick when the chunk was last saved. **{{nbt|list|sections}}: List of {{nbt|compound|Compounds}}, each tag is a section (also known as sub-chunk). All sections in the world's height are present in this list, even those who are empty (filled with air). ***{{nbt|compound}} An individual section. ****{{nbt|byte|Y}}: The Y position of this section. (Can also be an INT in 1.18+) ****{{nbt|compound|block_states}} *****{{nbt|list|palette}}: Set of different block states used in this particular section. ******{{nbt|compound}} A block *******{{nbt|string|Name}}: Block [[resource location]] *******{{nbt|compound|Properties}}: List of [[block state]] properties, with {{cd|name}} being the name of the block state property ********{{nbt|string|''Name''}}: The block state's name and its value. *****{{nbt|long-array|data}}: A packed array of 4096 indices pointing to the palette, stored in an array of 64-bit integers ({{nbt|long|Longs}}). ******If only one block state is present in the palette, this field is not required and the block fills the whole section. ******All indices are the same length. This length is set to the minimum amount of bits required to represent the largest index in the palette, and then set to a minimum size of 4 bits. Since 1.16, the indices are not packed across multiple elements of the array, meaning that if there is no more space in a given 64-bit integer for the whole next index, it starts instead at the first (lowest) bit of the next 64-bit integer. Different sections of a chunk can have different lengths for the indices. ****{{nbt|compound|biomes}} *****{{nbt|list|palette}}: Set of different biomes used in this particular section. ******{{nbt|string|Name}}: Biome [[resource location]] *****{{nbt|long-array|data}}: A packed array of 64 indices pointing to the palette, stored in an array of 64-bit integers ({{nbt|long|Longs}}). ******If only one biome is present in the palette, this field is not required and the biome fills the whole section. ******All indices are the same length: the minimum amount of bits required to represent the largest index in the palette. These indices do not have a minimum size. Different chunks can have different lengths for the indices. ****{{nbt|byte-array|BlockLight}}: 2048 {{nbt|byte|Bytes}} stores the amount of block-emitted light in each block. Makes load times faster compared to recomputing at load time. 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. ****{{nbt|byte-array|SkyLight}}: 2048 {{nbt|byte|Bytes}} stores the maximum sky light that reaches each block, regardless of current time. If the sky light data for a section is omitted you should look at the light data of the section directly above it. Take the 16x16 layer at the bottom of that section and repeat that light data 16 times to recompute the data for the omitted section. If there is no section above the current one, you are at the top section of the chunk. The light data for this top section should be set as completely bright (0xFF for each block). The format of how these levels is stored is the same as for BlockLight. **{{nbt|list|block_entities}}: Each {{nbt|compound|Compound}} in this list defines a block entity in the chunk. ***See [[#Block entity format|Block Entity Format]] below. ***If this list is empty, it becomes a list of {{cd|End}} tags. **{{nbt|compound|CarvingMasks}}: Only for ''proto-chunks'' '''(not confirmed for 1.18 format)'''. ***{{nbt|byte-array|AIR}}: A series of bits indicating whether a cave has been dug at a specific position, stored in a byte array. ***{{nbt|byte-array|LIQUID}}: A series of bits indicating whether an underwater cave has been dug at a specific position, stored in a byte array. **{{nbt|compound|Heightmaps}}: Several different [[heightmap]]s corresponding to 256 values compacted at 9 bits per value (lowest being 0, highest being 384, both values inclusive). The 9-bit values are stored in an array of 37 {{nbt|long|Longs}}, each containing 7 values ({{nbt|long|A Long}} = 64 bits, 7×9 = 63; the last bit is unused). In versions prior to 1.16 the heightmaps were stored in 36 {{nbt|long|Long}} values, where the bits were arranged in an uninterrupted "stream" across all values, resulting in all 2304 bits being used. The 9-bit values are unsigned, and indicate the amount of blocks above the bottom of the world. This means that converting a world to 1.18 adds 64 to every value. ***{{nbt|long-array|MOTION_BLOCKING}} ***{{nbt|long-array|MOTION_BLOCKING_NO_LEAVES}} ***{{nbt|long-array|OCEAN_FLOOR}} ***{{nbt|long-array|OCEAN_FLOOR_WG}} ***{{nbt|long-array|WORLD_SURFACE}} ***{{nbt|long-array|WORLD_SURFACE_WG}} **{{nbt|list|Lights}}: A List of 16 lists that store positions of light sources per chunk section as shorts, only for ''proto-chunks'' '''(not confirmed for 1.18 format)'''. **{{nbt|list|Entities}}: A list of entities in the ''proto-chunks'', used when generating. As of 1.17, this list is not present for fully generated chunks and entities are moved to a separated region files once the chunk is generated, see [[Entity format#Entity Format|Entity format]] for more details '''(not confirmed for 1.18 format)'''. ***{{nbt|compound}}: An entity. **{{nbt|list|fluid_ticks}}: A list of {{nbt|compound|Compounds}} ***Each {{nbt|compound|Compound}} in this list is an "active" liquid in this chunk waiting to be updated. See [[#Tile tick format|Tile Tick Format]] below. **{{nbt|list|block_ticks}}: A list of {{nbt|compound|Compounds}} ***Each {{nbt|compound|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|Tile Tick Format]] below. **{{nbt|long|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 [[Difficulty#Regional difficulty|Regional Difficulty]]. **{{nbt|compound|blending_data}}: This appears to be biome blending data, although more testing is needed to confirm. {{More_info}} ***{{nbt|int|min_section}}: {{More_info}} ***{{nbt|int|max_section}}: {{More_info}} **{{nbt|list|PostProcessing}}: A List of 24 {{nbt|list|Lists}} that store the positions of blocks that need to receive an update when a ''proto-chunk'' turns into a full chunk, packed in {{nbt|short|Shorts}}. Each list corresponds to specific section in the height of the chunk. ***See [[#ToBeTicked format|ToBeTicked format]] below for a description of the coordinate packing format. A common use case for this to is make liquids flow after generating a source block, such as springs in caves. **{{nbt|compound|structures}}: Structure data in this chunk. ***{{nbt|compound|References}}: Coordinates of chunks that contain ''Starts''. ****{{nbt|long-array|''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. ***{{nbt|compound|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 "{{cd|INVALID}}" and removing all other tags. ****{{nbt|compound|''Structure Name''}}: Only the structures that can spawn in this dimension are stored, for example, EndCity is stored only in the end chunks. *****{{nbt|int-array|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 {{cd|INVALID}}. *****{{nbt|string|biome}}: The biome id this structure is in. Absent if id is {{cd|INVALID}}. *****{{nbt|list|Children}}: List of structure pieces making up this structure, that were not generated yet. Absent if id is {{cd|INVALID}}. ******{{nbt|compound}} Structure piece data. {{info needed|Missing structure data from end cities, woodland mansions, igloos, pillager outposts, and the village data needs updating.}} *******{{nbt|int-array|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. *******{{nbt|string|BiomeType}}: The ocean temperature this ocean ruins is in. Valid values are WARM and COLD. *******{{nbt|byte|C}}: (Village "ViSmH") Hut roof type.{{verify|Still a thing since 1.14?}} *******{{nbt|compound|CA}}: (Village "ViF" and "ViDF") Crop in the farm plot.{{verify|Still a thing since 1.14?}} ********{{nbt|string|Name}}: Block [[resource location]] ********{{nbt|compound|Properties}}: List of [[block state]] properties, with [name] being the name of the block state property *********{{nbt|string|''Name''}}: The block state name and its value. *******{{nbt|compound|CB}}: (Village "ViF" and "ViDF") ********separate object with the same format as {{nbt|compound|CA}} *******{{nbt|compound|CC}}: (Village "ViDF") ********separate object with the same format as {{nbt|compound|CA}} *******{{nbt|compound|CD}}: (Village "ViDF") ********separate object with the same format as {{nbt|compound|CA}} *******{{nbt|byte|Chest}}: 1 or 0 ({{cd|true}}/{{cd|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. *******{{nbt|int|D}}: (Mineshaft "MSCrossing") Indicates the "incoming" direction for the crossing. *******{{nbt|int|Depth}}: (Temples and huts) Depth of the structure (X/Z). *******{{nbt|list|Entrances}}: (Mineshaft "MSRoom") List of exits from the room. ********{{nbt|int array}}: Bounding box of the exit. *******{{nbt|string|EntryDoor}}: (Stronghold) The type of door at the entry to this piece. *******{{nbt|int|GD}}: Appears to be some sort of measure of how far this piece is from the start. *******{{nbt|byte|hasPlacedChest0}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - (Desert temple) Whether 1st chest was placed. *******{{nbt|byte|hasPlacedChest1}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - (Desert temple) Whether 2nd chest was placed. *******{{nbt|byte|hasPlacedChest2}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - (Desert temple) Whether 3rd chest was placed. *******{{nbt|byte|hasPlacedChest3}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - (Desert temple) Whether 4th chest was placed. *******{{nbt|int|Height}}: (Temples and huts) Height of the structure (Y). *******{{nbt|int|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|Still a thing since 1.14?}} *******{{nbt|byte|hps}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - (Mineshaft "MSCorridor") Whether the corridor has a cave spider monster spawner. *******{{nbt|byte|hr}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - (Mineshaft "MSCorridor") Whether the corridor has rails. *******{{nbt|string|id}}: Identifier for the structure piece. Typically a heavily abbreviated code rather than something human-readable. {{info needed|it would be nice to know which enums this can be}} *******{{nbt|float|integrity}}: The integrity of this structure (only used by ocean ruins). *******{{nbt|byte|isLarge}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - If this ocean ruin is big. *******{{nbt|list|junctions}}: (Village) List of junction points. {{info needed}}{{verify|Still a thing since 1.14?}} ********{{nbt|compound}}: The junctions coordinates: *********{{nbt|int|source_x}}: X. *********{{nbt|int|source_ground_y}}: Y. *********{{nbt|int|source_z}}: Z. *********{{nbt|int|delta_y}}: Change Y. {{info needed}} *********{{nbt|string|dest_proj}}: One of {{cd|terrain_matching|rigid|d=or}}. *******{{nbt|byte|Left}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - (Stronghold "SHS") Whether the corridor has an opening on the left. *******{{nbt|byte|leftHigh}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - (Stronghold "SH5C") Whether the 5-way crossing has an exit on the upper level on the side with the upward staircase. *******{{nbt|byte|leftLow}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - (Stronghold "SH5C") Whether the 5-way crossing has an exit on the lower level on the side with the upward staircase. *******{{nbt|int|Length}}: (Village "ViSR") Length of the road piece.{{verify|Still a thing since 1.14?}} *******{{nbt|byte|Mob}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - (Fortress "NeMT") Whether this fortress piece should contain a blaze monster spawner but hasn't had one generated yet. (Stronghold "SHPR") Whether the silverfish monster spawner has been placed in this piece. *******{{nbt|int|Num}}: (Mineshaft "MSCorridor") Corridor length. *******{{nbt|int|O}}: Likely orientation of the structure piece. *******{{nbt|byte|placedHiddenChest}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - (Jungle temple) Whether the hidden chest was placed. *******{{nbt|byte|placedMainChest}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - (Jungle temple) Whether the main chest was placed. *******{{nbt|byte|placedTrap1}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - (Jungle temple) Whether the hallway arrow trap dispenser was placed. *******{{nbt|byte|placedTrap2}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - (Jungle temple) Whether the chest arrow trap dispenser was placed. *******{{nbt|int|PosX}}: The X coordinate origin of this village part.{{verify|Still a thing since 1.14?}} *******{{nbt|int|PosY}}: The Y coordinate origin of this village part.{{verify|Still a thing since 1.14?}} *******{{nbt|int|PosZ}}: The Z coordinate origin of this village part.{{verify|Still a thing since 1.14?}} *******{{nbt|byte|Right}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - (Stronghold "SHS") Whether the corridor has an opening on the right. *******{{nbt|byte|rightHigh}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - (Stronghold "SH5C") Whether the 5-way crossing has an exit on the upper level on the side with the downward staircase. *******{{nbt|byte|rightLow}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - (Stronghold "SH5C") Whether the 5-way crossing has an exit on the lower level on the side with the downward staircase. *******{{nbt|string|Rot}}: Rotation of ocean ruins and shipwrecks. Valid values are COUNTERCLOCKWISE_90, NONE, CLOCKWISE_90, and CLOCKWISE_180. *******{{nbt|byte|sc}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - (Mineshaft "MSCorridor") Whether the corridor has cobwebs. *******{{nbt|int|Seed}}: (Fortress "NeBEF") Random seed for the broken-bridge fortress piece. *******{{nbt|byte|Source}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - (Stronghold "SHSD") Whether the spiral staircase is the source of the Stronghold or was randomly generated. *******{{nbt|int|Steps}}: (Stronghold "SHFC") Length of the corridor *******{{nbt|int|T}}: (Village "ViSmH") Table: 0 is no table, 1 and 2 place it on either side of the hut.{{verify|Still a thing since 1.14?}} *******{{nbt|byte|Tall}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - (Stronghold "SHLi") Whether the library has an upper level. *******{{nbt|string|Template}}: The template of the ocean ruin or shipwreck that was used. *******{{nbt|byte|Terrace}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - (Village "ViSH") Whether the house has a ladder to the roof and fencing.{{verify|Still a thing since 1.14?}} *******{{nbt|byte|tf}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - (Mineshaft "MSCrossing") Whether the crossing is two floors tall. *******{{nbt|int|TPX}}: The X coordinate origin of this ocean ruin or shipwreck. *******{{nbt|int|TPY}}: The Y coordinate origin of this ocean ruin or shipwreck. *******{{nbt|int|TPZ}}: The Z coordinate origin of this ocean ruin or shipwreck. *******{{nbt|byte|Type}}: (Village) Village type: 0=plains, 1=desert, 2=savanna, 3=taiga.{{verify|Still a thing since 1.14?}} *******{{nbt|int|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. *******{{nbt|int|VCount}}: (Village) Count of villagers spawned along with this piece.{{verify|Still a thing since 1.14?}} *******{{nbt|int|Width}}: (Temples and huts) Width of the structure (X/Z). *******{{nbt|byte|Witch}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - (Witch hut) Whether the initial witch has been spawned for the hut. *******{{nbt|byte|Zombie}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - (Village) Whether this village generated as a zombie village.{{verify|Still a thing since 1.14?}} *****{{nbt|int|ChunkX}}: Chunk X coordinate of the start of the structure. Absent if id is {{cd|INVALID}}. *****{{nbt|int|ChunkZ}}: Chunk Z coordinate of the start of the structure. Absent if id is {{cd|INVALID}}. *****{{nbt|string|id}}: If there's no structure of this kind in this chunk, this value is "{{cd|INVALID}}", else it's the structure name. *****{{nbt|list|Processed}}: (Monument only) List of chunks that have had their piece of the structure created. Absent if id is {{cd|INVALID}}. ******{{nbt|compound}}: A chunk. *******{{nbt|int|X}}: The chunk's X position (chunk coordinates, not block coordinates). *******{{nbt|int|Z}}: The chunk's Z position. *****{{nbt|byte|Valid}}: 1 or 0 ({{cd|true}}/{{cd|false}}) - (Village only) Whether the village generated at least 3 non-roads. Absent if id is {{cd|INVALID}}.
== 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 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 (see [[Chunk_format#NBT_structure|NBT_structure]] above for details on the compression). There might be an additional section at the top and or bottom of the world used to store light, so that light travels properly over and under the world limits. The pseudo-code below shows how to access individual block information from a single section. 
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);
== Block entity format == {| class="wikitable" style="position:relative; z-index:1; float:right; margin-right:0" data-description="Block entity IDs" |- ! colspan="2" | Block Entities |- ! Block Entity ID ! Associated Block |- | banner | [[Banner]] |- | barrel | [[Barrel]] |- | beacon | [[Beacon]] |- | bed | [[Bed]] |- | beehive | [[Bee nest]]/[[beehive]] |- | bell | [[Bell]] |- | blast_furnace | [[Blast Furnace]] |- | brewing_stand | [[Brewing Stand]] |- | calibrated_sculk_sensor | [[Calibrated Sculk Sensor]] |- | campfire | [[Campfire]] |- | chest | [[Chest]] |- | chiseled_bookshelf | [[Chiseled Bookshelf]] |- | comparator | [[Redstone Comparator]] |- | command_block | [[Command Block]] |- | conduit | [[Conduit]] |- | crafter | [[Crafter]] |- | creaking_heart | [[Creaking Heart]] |- | daylight_detector | [[Daylight Detector]] |- | decorated_pot | [[Decorated Pot]] |- | dispenser | [[Dispenser]] |- | dropper | [[Dropper]] |- | enchanting_table | [[Enchanting Table]] |- | ender_chest | [[Ender Chest]] |- | end_gateway | [[End Gateway (block)|End Gateway]] |- | end_portal | [[End Portal (block)|End Portal]] |- | furnace | [[Furnace]] |- | hanging_sign | [[Hanging Sign]] |- | hopper | [[Hopper]] |- | jigsaw | [[Jigsaw Block]] |- | jukebox | [[Jukebox]] |- | lectern | [[Lectern]] |- | mob_spawner | [[Monster Spawner]] |- | piston | [[Moving Piston]] |- | shulker_box | [[Shulker Box]] |- | sign | [[Sign]] |- | skull | [[Mob head]] |- | sculk_catalyst | [[Sculk Catalyst]] |- | sculk_sensor | [[Sculk Sensor]] |- | sculk_shrieker | [[Sculk Shrieker]] |- | smoker | [[Smoker]] |- | soul_campfire | [[Soul Campfire]] |- | structure_block | [[Structure Block]] |- | suspicious_gravel | [[Suspicious Gravel]] |- | suspicious_sand | [[Suspicious Sand]] |- | trapped_chest | [[Trapped Chest]] |- | trial_spawner | [[Trial Spawner]] |- | vault | [[Vault]] |} 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.18 snapshots and that term is still used in some [[command]] usage. {{Data transclude|blockentity|Banner/BE|sprite=block|title=banners}} {{Data transclude|blockentity|Barrel/BE|sprite=block|title=barrel}} {{Data transclude|blockentity|Beacon/BE|sprite=block|title=beacon}} {{Data transclude|blockentity|Bed/BE|sprite=block|title=bed|icon=beds}} {{Data transclude|blockentity|Beehive/BE|sprite=block|title=beehive|icon=all-beehives}} {{Data transclude|blockentity|Bell/BE|sprite=block|title=bell}} {{Data transclude|blockentity|Blast Furnace/BE|sprite=block|link=Blast Furnace|title=blast_furnace}} {{Data transclude|blockentity|Brewing Stand/BE|sprite=block|link=Brewing Stand|title=brewing_stand}} {{Data transclude|blockentity|Calibrated Sculk Sensor/BE|sprite=block|link=Calibrated Sculk Sensor|title=calibrated_sculk_sensor}} {{Data transclude|blockentity|Campfire/BE|sprite=block|title=campfire}} {{Data transclude|blockentity|Chiseled Bookshelf/BE|sprite=block|title=chiseled_bookshelf|link=Chiseled Bookshelf}} {{Data transclude|blockentity|Chest/BE|sprite=block|title=chest}} {{Data transclude|blockentity|Redstone Comparator/BE|sprite=block|link=Redstone Comparator|title=comparator}} {{Data transclude|blockentity|Command Block/BE|sprite=block|link=Command Block|title=command_block|icon=command-blocks}} {{Data transclude|blockentity|Conduit/BE|sprite=block|link=Conduit|title=conduit}} {{Data transclude|blockentity|Crafter/BE|sprite=block|link=Crafter|title=crafter}} {{Data transclude|blockentity|Creaking Heart/BE|sprite=block|link=Creaking Heart|title=creaking_heart}} {{Data transclude|blockentity|Daylight Detector/BE|sprite=block|link=Daylight Detector|title=daylight_detector}} {{Data transclude|blockentity|Decorated Pot/BE|sprite=block|link=Decorated Pot|title=decorated_pot}} {{Data transclude|blockentity|Dispenser/BE|sprite=block|link=Dispenser|title=dispenser}} {{Data transclude|blockentity|Dropper/BE|sprite=block|title=dropper}} {{Data transclude|blockentity|Enchanting Table/BE|sprite=block|link=Enchanting Table|title=enchanting_table}} {{Data transclude|blockentity|Ender Chest/BE|sprite=block|link=Ender Chest|title=ender_chest}} {{Data transclude|blockentity|End Gateway (block)/BE|sprite=block|icon=end-gateway|link=End Gateway (block)|title=end_gateway}} {{Data transclude|blockentity|End Portal (block)/BE|sprite=block|icon=end-portal|link=End Portal (block)|title=end_portal}} {{Data transclude|blockentity|Furnace/BE|sprite=block|title=furnace}} {{Data transclude|blockentity|Hanging Sign/BE|sprite=block|title=hanging_sign|icon=oak hanging sign}} {{Data transclude|blockentity|Hopper/BE|sprite=block|title=hopper}} {{Data transclude|blockentity|Jigsaw Block/BE|sprite=block|title=jigsaw|link=Jigsaw Block}} {{Data transclude|blockentity|Jukebox/BE|sprite=block|link=Jukebox|title=jukebox}} {{Data transclude|blockentity|Lectern/BE|sprite=block|title=lectern}} {{Data transclude|blockentity|Monster Spawner/BE|sprite=block|link=Monster Spawner|title=mob_spawner}} {{Data transclude|blockentity|Piston/BE|sprite=block|title=piston}} {{Data transclude|blockentity|Sculk Catalyst/BE|sprite=block|link=Sculk Catalyst|title=sculk_catalyst}} {{Data transclude|blockentity|Sculk Sensor/BE|sprite=block|link=Sculk Sensor|title=sculk_sensor}} {{Data transclude|blockentity|Sculk Shrieker/BE|sprite=block|link=Sculk Shrieker|title=skulk_shrieker}} {{Data transclude|blockentity|Shulker Box/BE|sprite=block|link=Shulker Box|title=shulker_box}} {{Data transclude|blockentity|Sign/BE|sprite=block|title=sign|icon=oak sign}} {{Data transclude|blockentity|Head/BE|sprite=block|link=Head|title=skull|icon=heads}} {{Data transclude|blockentity|Smoker/BE|sprite=block|title=smoker}} {{Data transclude|blockentity|Campfire/BE|sprite=block|link=Soul Campfire|title=soul_campfire}} {{Data transclude|blockentity|Structure Block/BE|sprite=block|link=Structure Block|title=structure_block}} {{Data transclude|blockentity|Suspicious Block/BE|sprite=block|link=Suspicious Gravel|title=suspicious gravel}} {{Data transclude|blockentity|Suspicious Block/BE|sprite=block|link=Suspicious Sand|title=suspicious_sand}} {{Data transclude|blockentity|Chest/BE|sprite=block|title=trapped_chest|link=Trapped Chest}} {{Data transclude|blockentity|Trial Spawner/BE|sprite=block|title=trial_spawner|link=Trial Spawner}} {{Data transclude|blockentity|Vault/BE|sprite=block|title=vault|link=Vault}} {{-}} == 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.
* {{nbt|compound}} A Tile Tick ** {{:Chunk format/Tile Tick}}
== ToBeTicked format == This {{nbt|list|List}} is always present, and contains 16 {{nbt|list|Sublists}}, each representing one of the "sections" of the chunk. Those inside lists may contain {{nbt|short|Shorts}}, each representing a packed coordinate relative to the section : The 4 most significant bits are always 0, then each group of 4 bits (or nibble) represents a section-relative coordinate, from 0 to 15. The order of sections in the list appear to be ordered from bottom to top, and the packing order of the coordinates is {{cd|0ZYX}}, where {{cd|0}} refers to the chunk section. When converting ''proto-chunks'' to full chunks, only coordinates that are stored in PostProcessing appear to receive a tick update, tick updates stored in {{cd|block_ticks|fluid_ticks|d=and}} are ignored. {{verify|Further testing needed for confirmation.}} == History == {{Needs update|section=1|This history section is missing a significant number of changes, including most of the 1.13 changes, mainly the region file format.}} {{HistoryTable |{{HistoryLine|java beta}} |{{HistoryLine||1.2|Originally, chunks were stored as individual chunk files ".dat" where the file names contained the chunk's position encoded in Base36. | The format used was [[Java Edition Alpha level format]].}} |{{HistoryLine||1.3|The [[Region file format|Region]] format is introduced. |Chunks are now stored in groups of 32×32 chunks in individual ".mcr" files with the coordinates in Base10. |The goal was to reduce disk usage by cutting down on the number of file handles Minecraft had open at once.. }} |{{HistoryLine|java}} |{{HistoryLine||1.2.1|dev=12w07a|The [[Anvil file format]] is introduced. | Chunks are now divided into 16 individual 16×16×16 block sections. | Blocks, Data, BlockLight, and SkyLight arrays are now housed in individual chunk Sections. | The [[NBT Format]] now includes an integer array tag similar to the existing byte array tag. }} |{{HistoryLine||1.3.1|dev=12w21a|MaxExperience, RemainingExperience, ExperienceRegenTick, ExperienceRegenRate and ExperienceRegenAmount from MobSpawner have been removed.}} |{{HistoryLine||1.4.2|dev=12w34a|Added entity WitherBoss.}} |{{HistoryLine||1.5|dev=13w02a|Added entity MinecartTNT. |Minecart is now deprecated.}} |{{HistoryLine|||dev=13w03a|Added entity MinecartHopper.}} |{{HistoryLine|||dev=13w06a|Added entity MinecartSpawner.}} |{{HistoryLine||1.6.1|dev=13w16a|Added entity EntityHorse.}} |{{HistoryLine|||dev=13w21a|ArmorType has been removed from EntityHorse. |Saddle has been removed from EntityHorse.}} |{{HistoryLine|||dev=release|Saddle to EntityHorse has been re-added.}} |{{HistoryLine||1.7.2|dev=13w39a|Added entity MinecartCommandBlock.}} |{{HistoryLine|||dev=13w42a|Added CanBreakDoors to Zombie.}} |{{HistoryLine||1.8|dev=14w02a|Added Lock to containers. |[[Item]] IDs are no longer used when specifying NBT data. |Added Block to FallingSand, using the alphabetical ID format.}} |{{HistoryLine|||dev=14w06a|Added ShowParticles to all [[mob]]s. |Added PickupDelay to [[item]] [[entity|entities]]. |Setting Age to -32768 makes items, which never expire. |AttackTime has been removed from [[mob]]s.}} |{{HistoryLine|||dev=14w10a|Added rewardExp to Villager. |Added OwnerUUID for mobs that can [[breeding|breed]]. |Added Owner to Skull. |Changes to [[item frame]]s and [[painting]]s: 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.}} |{{HistoryLine|||dev=14w11a|Added [[entity]] Endermite. |Added EndermiteCount to Enderman.}} |{{HistoryLine|||dev=14w21a|CustomName and CustomNameVisible now work for all [[entity|entities]].}} |{{HistoryLine|||dev=14w25a|Added entity Guardian. |Added Text1, Text2, Text3 and Text4 to [[sign]]s. The limit no longer depends on the amount of characters (16), it now depends on the width of the characters.}} |{{HistoryLine|||dev=14w27a|Added entity Rabbit. Added CommandStats to [[command block]]s and signs.}} |{{HistoryLine|||dev=14w28a|EndermiteCount has been removed from Enderman.}} |{{HistoryLine|||dev=14w30a|Added Silent for all [[entity|entities]].}} |{{HistoryLine|||dev=14w32a|Added NoAI for all [[mob]]s. |Added entity ArmorStand.}} |{{HistoryLine|||dev=14w32c|Added NoBasePlate to ArmorStand.}} |{{HistoryLine||1.9|dev=15w31a|Added [[tag]]s 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.}} |{{HistoryLine|||dev=15w32a|Tags and DataVersion tag can now be applied on [[entity|entities]]. |Changed the Fuse tag's type for the PrimedTnt entity from "Byte" to "Short".}} |{{HistoryLine|||dev=15w32c|Introduced a limit on the amount of [[tag]]s an entity can now have (1024 tags). When surpassed it displays an error saying: "Cannot add more than 1024 tags to an entity."}} |{{HistoryLine|||dev=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.}} |{{HistoryLine|||dev=15w33c|Added BeamTarget to EnderCrystal.}} |{{HistoryLine|||dev=15w34a|Added powered and conditional byte [[tag]]s to Control tile [[entity]] for [[command block]]s. |Added life and power to FireballBase. |Added id inside SpawnData to MobSpawner. |Added powered to the Music tile entity for [[note block]]s.}} |{{HistoryLine|||dev=15w35a|Added VillagerProfession to Zombie.}} |{{HistoryLine|||dev=15w37a|Added Enabled to MinecartHopper.}} |{{HistoryLine|||dev=15w38a|Added SkeletonTrap and SkeletonTrapTime to EntityHorse.}} |{{HistoryLine|||dev=15w41a|Riding has been replaced with Passengers for all [[entity|entities]]. |Added RootVehicle for all passengers. |Added Type to Boat.}} |{{HistoryLine|||dev=15w42a|Added Fuel to Cauldron ([[brewing stand]]s).}} |{{HistoryLine|||dev=15w43a|Added LootTable and LootTableSeed to Chest, Minecart and MinecartHopper. |Added DeathLootTable and DeathLootTableSeed to all [[mob]]s. |Added life and power to all [[fireball]]s (FireballBase).}} |{{HistoryLine|||dev=15w44a|Added ShowBottom to EnderCrystal.}} |{{HistoryLine|||dev=15w44b|Added Potion and CustomPotionEffects to Arrow. |Added Potion to AreaEffectCloud.}} |{{HistoryLine|||dev=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.}} |{{HistoryLine|||dev=15w46a|MoreCarrotTicks from Rabbit is now set to 40 when [[rabbit]]s eat a [[carrot|carrot crop]], but is not used anyway.}} |{{HistoryLine|||dev=15w47a|Added PaymentItem to Beacon.}} |{{HistoryLine|||dev=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.}} |{{HistoryLine|||dev=15w51b|The original values of DisabledSlots in ArmorStand have been changed in nature.}} |{{HistoryLine||1.10|dev=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 [[entity|entities]]. |Added powered, showboundingbox and showair to Structure.}} |{{HistoryLine|||dev=16w21a|Added FallFlying to [[mob]]s and [[armor stand]]s. |Added integrity and seed to Structure.}} |{{HistoryLine|||dev=pre1|Added ParticleParam1 and ParticleParam2 to AreaEffectCloud.}} |{{HistoryLine||1.11|dev=16w32a|[[Horse]]s 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 [[tag]]s now apply only to skeleton_horse. |[[Skeleton]]s have been split into entity IDs skeleton, stray and wither_skeleton. SkeletonType tag is removed from all skeleton types. |[[Zombie]]s 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. |[[Guardian]]s 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.}} |{{HistoryLine|||dev=16w35a|Added CustomName to banner.}} |{{HistoryLine|||dev=16w39a|Added llama, llama_spit, vindication_illager, vex, evocation_fangs and evocation_illager. |Added Color to shulker. |Added LocName, CustomPotionColor and ColorMap to [[item]]s.}} |{{HistoryLine|||dev=16w40a|Added Johnny to vindication_illager. |Removed xTile, yTile, zTile, inTile, inGround from the FireballBase class (in large [[fireball]]s, small fireballs, [[dragon fireball]]s, and [[Wither#Wither Skull|wither skull]]s).}} |{{HistoryLine|||dev=16w41a|llama_spit is now available as a save game entity.}} |{{HistoryLine|||dev=16w42a|Added crit to arrow.}} |{{HistoryLine|||dev=16w43a|Added OwnerUUIDLeast and OwnerUUIDMost to evocation_fangs.}} |{{HistoryLine|||dev=16w44a|xTile, yTile, zTile, inTile, inGround have been removed from the fishing bobber entity.}} |{{HistoryLine|||dev=pre1|ench has been changed to require at least one compound.}} |{{HistoryLine||1.12|dev=17w13a|Added entity Parrot, ShoulderEntityLeft/ShoulderEntityRight, seenCredits, recipeBook and Recipes.}} |{{HistoryLine|||dev=17w14a|Added isFilteringCraftable, isGuiOpen and recipes to recipeBook, which is now a compound [[tag]]. |Added ConversionPlayerLeast and ConversionPlayerMost to [[entity]] Zombie.}} |{{HistoryLine|||dev=17w16a|NBT parsing in commands has been improved.}} |{{HistoryLine|||dev=17w17a|Added toBeDisplayed to recipeBook, UpdateLastExecution and LastExecution.}} |{{HistoryLine|||dev=17w17b|Added LoveCauseLeast and LoveCauseMost to [[breeding|breedable]] [[entity|entities]].}} |{{HistoryLine||1.13|dev=17w47a|The {{code|damage}} tag from items removed, tools and armor now use {{code|Damage}} and maps use {{code|map}}, both in {{code|tag}}. |Endermen's {{code|carried}} and {{code|carriedData}} merged into {{code|carriedBlockState}}. |Arrows' {{code|inTile}} and {{code|inData}} merged into {{code|inBlockState}}. |Minecarts' {{code|DisplayTile}} and {{code|DisplayData}} merged into {{code|DisplayState}}. |Falling blocks' {{code|Block}} and {{code|Data}} merged into {{code|BlockState}}. |Moving pistons' {{code|BlockId}} and {{code|BlockData}} merged into {{code|blockState}}. |Removed note block and flower pot block entities. |Trapped chests now have their own block entity {{code|trapped_chest}}. |Removed {{code|Base}} from banners. |Removed {{code|Rot}} from heads.}} |{{HistoryLine|||dev=17w47a|Removed {{code|Record}} from jukeboxes.}} |{{HistoryLine|||dev=17w47b|Trapped chests no longer have their own block entity, and again use {{code|chest}}.}} |{{HistoryLine|||dev=18w01a|Thrower and Owner has been changed from strings to compounds with two longs named L and M.}} |{{HistoryLine|||dev=18w02a|Bobbers created by fishing rods now have the entity ID fishing_bobber. |Painting motives are now lowercased and namespaced.}} |{{HistoryLine|||dev=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.}} |{{HistoryLine|||dev=18w15a|Added dolphin entity.}} |{{HistoryLine|||dev=18w19a|Renamed {{code|puffer_fish}} to {{code|pufferfish}}.}} |{{HistoryLine|||dev=18w20a|Renamed {{code|cod_mob}} to {{code|cod}}. |Renamed {{code|salmon_mob}} to {{code|salmon}}.}} |{{HistoryLine|||dev=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.}} |{{HistoryLine|||dev=pre5|Renamed {{code|xp_orb}} to {{code|experience_orb}}. |Renamed {{code|xp_bottle}} to {{code|experience_bottle}}. |Renamed {{code|eye_of_ender_signal}} to {{code|eye_of_ender}}. |Renamed {{code|ender_crystal}} to {{code|end_crystal}}. |Renamed {{code|fireworks_rocket}} to {{code|firework_rocket}}. |Renamed {{code|commandblock_minecart}} to {{code|command_block_minecart}}. |Renamed {{code|villager_golem}} to {{code|iron_golem}}. |Renamed {{code|evocation_fangs}} to {{code|evoker_fangs}}. |Renamed {{code|evocation_illager}} to {{code|evoker}}. |Renamed {{code|vindication_illager}} to {{code|vindicator}}. |Renamed {{code|illusion_illager}} to {{code|illusioner}}.}} |{{HistoryLine||1.14|dev=18w43a|Added illager_beast, panda, and pillager entities.}} |{{HistoryLine|||dev=18w45a|The LIGHT_BLOCKING heightmap has been removed.}} |{{HistoryLine||1.15|dev=19w36a|The {{nbt|int array|Biomes}} array in the {{nbt|compound|Level}} tag for each chunk now contains 1024 integers instead of 256, allowing biomes to differ based on altitude.}} |{{HistoryLine||1.17|dev=20w45a|Entities have been extracted from main (terrain) chunks and are now stored in separate entities directory (similar to POI storage). Those new files are still region files with NBT.}} |{{HistoryLine|||dev=20w51a|Added axolotl.}} |{{HistoryLine|||dev=21w03a|Added glow_squid.}} |{{HistoryLine|||dev=21w13a|Added goat.}} |{{HistoryLine||1.20.2|dev=23w32a|Game no longer uses numeric values when storing mob effects to world. For example, 4 becomes minecraft:mining_fatigue.|Changed following fields in mob effect instances: * Id (integer) -> id (string, resource identifier) * Ambient -> ambient * Amplifier -> amplifier * Duration -> duration * ShowParticles -> show_particles * ShowIcon -> show_icon * HiddenEffect -> hidden_effect * FactorCalculationData -> factor_calculation_data |In NBT format for block entity type beacon: * Primary (integer) -> primary_effect (string, resource identifier) * Secondary (integer) -> secondary_effect (string, resource identifier)}} |{{HistoryLine||1.21|dev=24w21a|Renamed Attributes field in mob data to attributes |Changed following fields in mob attributes: * Name -> id * Base -> base * Modifiers -> modifiers |Changed following fields in mob attribute modifiers: * UUID (int array) and Name (arbitrary string) -> id (string, resource identifier) * Amount -> amount * Operation (integer) -> operation (string), with "add_value" replacing 0, "add_multiplied_base" replacing 1, and "add_multiplied_total" replacing 2}} }} ==References== {{Reflist}} == Navigation == {{Navbox Java Edition technical|general}} [[Category:Development]] [[de:Chunkdaten]] [[fr:Format de chunk]] [[ja:Chunkフォーマット]] [[ko:청크 형식]] [[nl:Segment formaat]] [[pt:Formato de chunk]] [[ru:Формат чанка]] [[uk:Формат чанку]] [[zh:区块存储格式]]