A simple lua(JIT) library to read and write .nbs files from Open Note Block Studio. Also works with CC:T.

luanbs has all the functionality pynbs has, like iterating over Note Block Studio songs

local luanbs = require "luanbs"

for _, note in pairs(luanbs.read("example.nbs").notes) do
  print("tick:", note.tick, "instrument:", note.instrument)
end

or generating new songs programmatically

local luanbs = require "luanbs"

let song = {header = {}, layers = {{}}, notes = {}, instruments = {}}
for i in 1 .. 10 do
  table.insert(song.notes, {tick: i, velocity: 30, key: i+35})
end

the main difference is that every non-table field can be nil, where nil acts as 0/"".

The package can be installed with luarocks

$ luarocks install rsnbs

or src can be copied into your computer and renamed to luanbs if you're using CC:T.

You can use the luanbs.read function to read an parse a specific NBS file of any version.

let song = rsnbs::read_nbs("song.nbs");

This returns a table wich can then be written using luanbs.save

luanbs.save("song.nbs", song, version);

where version = nil saves it in the newest version.

The first field is header, the file header. It contains information about the file.

The notes attribute holds a list of all the notes of the song in order.

The layers attribute holds a list of all the layers of the song in order.

The instruments attribute holds a list of all the custom instruments of the song in order.