nbt

This is a Python libary for working with Named Binary Tag (NBT) files and data structures.

NOTE: this Python package is not fully set up yet (will fix).

Named Binary Tags

For the specification for NBT, see the file "Named Binary Tags.txt", which is taken from Markus Perrson's original specification.

Example usage

It is meant to be straightforward to read, write, and manually create NBT data structures.

Example 1

Example of creating a NBT data structure and saving it to a file:

from nbt import NamedTag, TagCompound, TagFloat, TagDouble
from nbt.printing import print_tag

# Create a NBT tag from scratch
x = NamedTag("Position data", TagCompound({
    "x": TagFloat(3.0),
    "y": TagFloat(-12.43),
    "z": TagDouble(88.31),
}))

# Write NBT compound tag to a file
with open("example 1.nbt", "wb") as f_out:
    x.write_to_file(f_out)
    # Print NBT data in a readable form
    print_tag(x)

Example 2

Example of reading a saved NBT file:

from nbt import NamedTag
from nbt.printing import print_tag

# Read a NBT tag from a file (assuming file "example 1.nbt" already exists and is not gzipped)
with open("example 1.nbt", "rb") as f_in:
    y = NamedTag.read_from_file(f_in)
    # Print NBT data in a readable form
    print_tag(y)