#minecraft #binary-format #nbt #serialization #file-format #serde #read-write

hematite-nbt

A full-featured library for working with Minecraft's Named Binary Tag (NBT) file format, including Serde support

8 releases (4 breaking)

Uses old Rust 2015

0.5.2 May 15, 2021
0.5.1 Feb 22, 2021
0.5.0 Aug 18, 2020
0.4.1 Aug 20, 2019
0.1.0 Dec 1, 2015

#1136 in Encoding

Download history 203/week @ 2024-10-31 82/week @ 2024-11-07 88/week @ 2024-11-14 161/week @ 2024-11-21 210/week @ 2024-11-28 213/week @ 2024-12-05 411/week @ 2024-12-12 193/week @ 2024-12-19 343/week @ 2024-12-26 322/week @ 2025-01-02 220/week @ 2025-01-09 307/week @ 2025-01-16 173/week @ 2025-01-23 207/week @ 2025-01-30 406/week @ 2025-02-06 358/week @ 2025-02-13

1,203 downloads per month
Used in 26 crates (24 directly)

MIT license

87KB
2K SLoC

hematite_nbt hematite_nbt at crates.io hematite_nbt at docs.rs Build Status

This repository contains the Hematite project's standalone nbt crate for working with Minecraft's Named Binary Tag (NBT) format.

This is not the only NBT-related crate available, but it has some notable features:

  • Full support for serializing and deserializing types via Serde. This means that you can read and write the NBT binary format of any struct annotated with the standard #[derive(Serialize, Deserialize)] traits (provided it actually has a valid NBT representation).

  • An API that attempts to differentiate between complete and partial NBT objects via nbt::Blob and nbt::Value. Only complete objects can be serialized.

  • Support for the TAG_Long_Array data introduced in Minecraft 1.12.

  • Support for the modified UTF-8 encoding used by the vanilla Minecraft client.

License

Licensed under the terms of the MIT license.

Dependencies

~0.7–1.5MB
~31K SLoC