LibNBT++

libnbt++ is a free C++ library for Minecraft's file format Named Binary Tag (NBT). It can read and write compressed and uncompressed NBT files and provides a code interface for working with NBT data.

v3.1 Active

libnbt++3 is a remake of the old libnbt++2 library with the goal of making it more easily usable and fixing some problems. The old libnbt++2 especially suffered from a very convoluted syntax and boilerplate code needed to work with NBT data.

Building

This project uses CMake for building. Ensure you have CMake installed.

Prerequisites

C++11 compatible compiler
CMake 3.15 or later
ZLIB (optional, for compressed NBT support)

Build Steps

Clone the repository:

git clone https://github.com/Project-Tick/Project-Tick.git
cd Project-Tick/libnbtplusplus/

Create a build directory:
```
mkdir build
cd build
```
Configure with CMake:
```
cmake ..
```
Options:
- NBT_BUILD_SHARED=OFF (default): Build static library
- NBT_USE_ZLIB=ON (default): Enable zlib support
- NBT_BUILD_TESTS=ON (default): Build tests
Build:
```
cmake --build .
```
Install (optional):
```
cmake --install .
```

Usage

Include the headers and link against the library.

Example

#include <nbt_tags.h>
#include <fstream>
#include <iostream>

int main() {
    // Read an NBT file
    std::ifstream file("example.nbt", std::ios::binary);
    nbt::tag_compound root = nbt::io::read_compound(file).first;

    // Access data
    std::cout << root["some_key"].as<nbt::tag_string>() << std::endl;

    return 0;
}