🎹
Open Note Block Studio
  • Welcome to Note Block Studio
  • Introduction
    • Getting Started
    • Composing Music
    • Macros
    • Exporting Music
      • Audio Track
      • Schematic
      • Track Schematic
      • Branch Schematic
      • Data Pack
    • Advanced Guide
      • Eastern Note Block Style
    • Shortcuts
  • Settings
    • Preferences
  • Schematics
  • NBS Format
  • Credits
  • OpenNBS License
  • OpenNBS Website
  • OpenNBS Discord
  • OpenNBS YouTube
Powered by GitBook
On this page

NBS Format

You really need to know what are the "Formats"

PreviousSchematicsNextCredits

Last updated 2 years ago

The .nbs format (Note Block Song) was created to work with Minecraft Note Block Studio, and contains data about how note blocks are laid out in the program to form a song. To bring new features to Note Block Studio and make it future-proof, we are using an improved file format. The first 2 bytes of the .nbs file have been changed to 0 to indicate the new format. All the data types found in a .nbs file are , and in . Strings consist of a 32-bit integer, and then that many bytes for the characters. The file is made up of four parts, two of which are mandatory:

  • Header

  • Note Blocks

  • Layers (Optional)

  • Custom Instruments (Optional)

If the information provided below differs from the old .nbs format, they are marked Green.

Version 1:

  • The first two bytes, which used to indicate the song length, have been changed to 0 to indicate the new format.

  • The NBS version is now stored in the file.

  • The byte after the NBS version is now the amount of vanilla instruments. This change was necessary because, previously, the program didn't know when the custom instruments began. It always went up to 9, and everything after that was treated as a custom instrument.

Version 2:

  • Now stereo information is saved for each layer. This means that now the sound can pan to the left/right.

  • For every layer, there's now a byte that determines how much that layer pans. 0 is 2 blocks right, 100 is centre, 200 is 2 blocks left.

Version 3:

  • Song length is now saved again after the vanilla instrument count.

Version 4:

  • Loop on/off, max loop count, and loop start tick are now saved.

  • The program now saves which layers are locked.

  • Note blocks now store velocity, panning, and pitch. These work in conjunction with layer volume and layer stereo.

Version 5:

  • May now hold up to 240 custom instruments, previously 18.

  • The path to custom sound files may contain slash characters, as a result of allowing custom sounds to be loaded from subfolders.

  • No fields have been added or removed, so version 5 files may be read identically to version 4.

signed
little-endian