Minecraft NBT Reader/Writer for Swift

This package provides a read/write process for Minecraft NBT data structures.

It also has preliminary (not fully tested!) support for using "NBTEncoder" and "NBTDecoder" to decode/encode NBT these structures into Swift classes/structs.

Quick Start

Load Data

The data should be the uncompressed stream in Data type.

// Data is the decompressed data of the NBT file
guard var structure = NBTStructure(decompressed: data) else {
    print("Failed to read data")
    exit(0)
}

For compressed data, only the GZip format can be used.

// Data is the compressed data of the NBT file
guard var structure = NBTStructure(compressed: data) else {
    print("Failed to read data")
    exit(0)
}

The structure tag provides:

• A tag property which is the compound root tag of the NBT. You can use this tag to manually traverse the NBT structure.
• read and write functions that both take an array of strings (text or numerical values for indexes and compound tags, respectively) and either a value to write, or return the value found.

Read

There are two ways to read data.

Simple Read

try structure.read(["", "Data", "ServerBrands", "0"])

Layer-by-layer Read

// Get compound of NBT file
var compound = structure.tag

// Read data from compound
var keys = compound.contents.keys
var someIntValue = compound["intValue"]
var someStringValue = compound["stringValue"]

// Read data from list
var list = compound["listValue"] as! NBTList
var someValue = list.elements[0]

Note

Level.dat (and others) may have a blank key as the first tag in the structure (seen above in the read command).