Skip to main content

nbtx - NBT parser in Python

Zero-dependency, strictly-typed NBT parser and writer.

Installation (Library)

Because the entire implementation finds place in a single file and does not depend on third-party libraries, you can simply copy src/nbtx/__init__.py to your project. Alternatively, you can install nbtx by using a package manager.

Pip

pip install nbtx

Poetry

poetry add nbtx

uv

uv add nbtx

Installation (CLI)

pipx

pipx install nbtx

Usage (Library)

import nbtx

with open("file.nbt", "rb") as f:
    content = nbtx.load(f)

print(content.pretty())

Usage (CLI)

You can display the contents of an NBT file by using the CLI of nbtx:

Read Big Endian NBT File

cat samples/bigtest.nbt | nbtx -e big
# or
nbtx -e big samples/bigtest.nbt

Read Little Endian NBT File

cat samples/caged_villager.mcstructure | nbtx -e little
# or
nbtx -e little samples/caged_villager.mcstructure

References

Metadata

Release files for nbtx 0.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nbtx 0.4.1
File Size Uploaded
nbtx-0.4.1.tar.gz 9.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for nbtx 0.4.1
File Interpreter ABI Platform
nbtx-0.4.1-py3-none-any.whl Python 3 none any Details

Total release size: 18.9 kB

Release files / nbtx-0.4.1.tar.gz

Download URL nbtx-0.4.1.tar.gz
Size 9.0 kB
Tags Source
SHA-256 checksum
How to use checksums
4cff89779883ef639a71ca31c39b56bca4f238b4f1bebcd9527c871eda22955b
BLAKE2b-256 checksum
How to use checksums
05aa5ddb9e17f34ce158774476c05e144076ee8b467be3cb7022c434df0df94c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.1.3 CPython/3.11.14 Linux/6.17.5-arch1-1

Release files / nbtx-0.4.1-py3-none-any.whl

Download URL nbtx-0.4.1-py3-none-any.whl
Size 9.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cea2abc9126ab5788cef5898fbb4e83396429dcb4437b4ba9417c8a7c07be755
BLAKE2b-256 checksum
How to use checksums
6651e6f3f0b75a2494e5ab1e5914535b03834a2a50edacd93e0ec3006a14d6c3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.1.3 CPython/3.11.14 Linux/6.17.5-arch1-1

Release history Release notifications | RSS feed

This release

0.4.1 This release

2 release files

0.4.0

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.0

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page