Documentation: docs.rs
Fast (or trying to be!) deserializer and parser for Minecraft: Java Edition's NBT format.
Includes
Read trait.The derserializer allows you to avoid allocations where possible. Strings can be
deserialized to &'a str where 'a is the lifetime of the data being
deserialized. This can also be done for lists of any integral type into
&'a [u8]. The same applies to the Array types in NBT.
See the documentation for more information.
toml
[dependencies]
fastnbt = "0.19"
There are other crates for NBT out there, this tries to give an honest
comparison to them. The Hemtite nbt crate was the only other crate I found with serde deserialization.
| Feature | fastnbt | Hematite nbt | note |
| ------- | --------- | -------------- | ---- |
| Benchmark world render time (relative)* | 1.00 | 1.37 | fastnbt is ~37% faster. See note. |
| Deserialization | yes | yes | |
| Serialization | no | yes | |
| Value-like type | yes | yes | |
| Long Array (MC 1.12+) | yes | yes | |
| Minecraft specialized unicode | no** | yes | |
| Deserialize from reader | no | yes | |
| WASM compatible | yes | unknown | |
* This is rendering the overworld of Etho's Lets Play Episode. Exact relative
figures are 1000±13 for fastnbt and 1370±7 for hematite-nbt. This used the
anvil tiles executable, swapping out the deserializer only, so performance
tweaks in rendering chunks are not counted.
**intended feature
Some things I want to finish off properly for 1.0
Value type can be perfectly reserialised if serialization is ever supported.