Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

NBT.js – a JavaScript parser for NBT archives

tag: v0.1.0

Fetching latest commit…

Cannot retrieve the latest commit at this time



by Sijmen Mulder.

NBT.js is a JavaScript parser for uncompressed NBT archives, for use with Node.js.


After var nbt = require('nbt'), you can use nbt.parse(data) to convert uncompressed NBT data into a regular JavaScript object.

var fs = require('fs'),
    nbt = require('nbt');

fs.readFile('bigtest.nbt', function(error, data) {
    if (error) throw error;

    var result = nbt.parse(data);
    console.log(result.Level['nested compound test']);

Tag names are copied verbatim, and as some names are not valid JavaScript names, use of the indexer may be required – such as with the nested compound test in the example above.

Byte arrays are returned as Node.js Buffer objects.

Known issues

  • No formal test cases (only a sample program)
  • 64 bit integers overflow


I, the copyright holder of this work, hereby release it into the public domain. This applies worldwide.

In case this is not legally possible: I grant anyone the right to use this work for any purpose, without any conditions, unless such conditions are required by law.

Something went wrong with that request. Please try again.