Subchunk (/) Data Format
Byte Order
Subchunk data is stored in Little Endian byte order.
Parsing The Subchunk
NOTE: Bedrock subchunks are only saved to disk if they have changed since world generation.
| Name | Size (in bytes) | Description |
|---|---|---|
| Version | 1 | The version of this subchunk. |
If Version is 8 or 9
| Name | Size (in bytes) | Description |
|---|---|---|
| Block Layer Count | 1 | The number of block layers this subchunk has. |
| Y-Index | 1 | The Subchunk Y Position (ranges from -4 to 19). (Only exists if Version is 9) |
Now loop the next section Block Layer Count times until you have parsed all block layers.
If Palette Type is 0
| Name | Size (in bytes) | Description |
|---|---|---|
| Layer Indices | ceil(4096[1] ÷ Indices Per Block[2]) × 4 | Stored in blocks of 32 bits, with each block containing Indices Per Block indices, each occupying Bits Per Index bits. If Bits Per Index is 3, 5 or 6, then 2 bits of padding are on the most-significant/left-most side of each block, with indices packed into the remaining 30 bits. The indices are packed and stored in YZX order (Y increments first). |
| NBT Palette Compound Count | 4 | The number of NBT compounds to parse |
| NBT Palette Compounds | Variable | Multiple NBT compounds of individual blocks of the palette used in this subchunk |
If Palette Type is 1 (Might not be used in practice)
| Name | Size (in bytes) | Description |
|---|---|---|
| Layer Indices | ceil(4096[1] ÷ Indices Per Block[2]) × 4 | Stored in blocks of 32 bits, with each block containing Indices Per Block indices, each occupying Bits Per Index bits. If Bits Per Index is 3, 5 or 6, then 2 bits of padding are on the most-significant/left-most side of each block, with indices packed into the remaining 30 bits. The indices are packed and stored in YZX order (Y increments first). |
| NBT Palette Compound Count | 1 Signed VarInt (ZigZag) | The number of NBT compounds to parse |
| NBT Palette Compounds | Variable | Multiple NBT compounds of individual blocks of the palette used in this subchunk |
If Version is 0 or between 2 and 7
NOTE: Second block layer for this version uses LegacyBlockExtraData (4) key instead, rather then being stored with the subchunk like in newer versions of the format.
| Name | Size (in bytes) | Description |
|---|---|---|
| Block IDs | 4096 | 8 bits per block. All the block ids for this chunk stored in YZX order (Y increments first) |
| Block Data | 2048 | 4 bits per block. All the data values for the blocks in this chunk stored in YZX order (Y increments first) |
| Skylight | 2048 | 4 bits per block. May be omitted. All the skylight data for this chunk stored in YZX order (Y increments first) |
| Blocklight | 2048 | 4 bits per block. May be omitted. All the blocklight data for this chunk stored in YZX order (Y increments first) |
Notes
- In some languages you may need to write this as
4096.0instead of just4096for the correct output. - Indices Per Block = floor(32 ÷ Bits Per Index)
Contributors
BJTMastermind
robofinch