Module nbt

This module contains all structs related to the nbt data in the chunks

Note: Many of the descriptions for the fields/structs in this module come directly from the Minecraft Wiki, with some occasional modifications to make them make more sense (at least in this context). The latest update to these descriptions was on 5 March 2024, and I’ll try to keep them updated.

<rant>
Mojang has the worst naming conventions ever! Sometimes they use snake_case, sometimes they use PascalCase, other times they use camelCase, sometimes it’s SCREAMING_SNAKE_CASE! This is so annoying when dealing with Mojang things! Feel free to look at the name changes on almost every field in this module just to make it happy and you’ll be just as annoyed as I am!
</rant>

Structs

Biomes

See https://minecraft.wiki/w/Chunk_format#NBT_structure

BlendingData

From the wiki: This appears to be biome blending data, although more testing is needed to confirm.

BlockState

Data which represents a block in a chunk

BlockStates

See https://minecraft.wiki/w/Chunk_format#NBT_structure

ChunkNbt

The represents that chunk’s nbt data stored in the region file

ChunkSection

The represents a section (or subchunk) from a chunk’s NBT data stored in the region file

HeightMap

Wrapper type around a LongArray to abstract away the details of how the HeightMaps store their data

HeightMaps

Several different heightmaps corresponding to 256 values compacted at 9 bits per value (lowest being 0, highest being 384, both values inclusive).

NamespacedKey

A struct which represents a key with a namespace

TileTick

See https://minecraft.wiki/w/Chunk_format#Tile_tick_format

Enums

Namespace

Represents a namespace that can show up in the game