WirelessNBS

Turns a .nbs file into a Wireless Noteblock Piece via datapack.

Prerequisites

This program requires >= Python 3.6, pip, Git, PyNBS, Open Note Block Studio, and Minecraft.

PyNBS can be installed with pip:

$ pip3 install pynbs

NBS files can be made using Open Note Block Studio, and the datapack can be run using Minecraft.

Installation

To install or update this program, simply do this:

$ git clone https://github.com/miclol/WirelessNBS

If you don't have git, just download the zipped source and unzip.

NBS Validity

When making a NBS file, make sure the notes are within the Minecraft limit and you're not using any custom instruments. Use the image below to validate whether the program can support the .nbs file.

Config File Setup

Before you use this program you must create a file with the same name as the .nbs file but instead of .nbs, the filetype needs be .txt, and put it in the WirelessNBS directory. (If .nbs file is Example.nbs , then create Example.txt).

The formatting of the TXT file is as follows:

<instrument 1> <X Coordinate> <Y Coordinate> <Z Coordinate>
<instrument 2> <X Coordinate> <Y Coordinate> <Z Coordinate>
...
obstructions <X Coordinate> <Y Coordinate> <Z Coordinate>

The list of valid instruments are as follows (note that it is case-sensitive) with it's instrument block:

Valid Instrument	Instrument Block
piano	Any Other Block not mentioned
double bass	Wood-Based Blocks
bass drum	Stone-Based Blocks
snare drum	Sand, Gravel, Concrete Powder
click	Glass, Sea Lantern, Beacon
guitar	Wool
flute	Clay
bell	Block of Gold
chime	Packed Ice
xylophone	Bone Block
iron xylophone	Block of Iron
cow bell	Soul Sand
didgeridoo	Pumpkin
bit	Block of Emerald
banjo	Hay Bale
pling	Glowstone

You can also configure obstructing blocks, using obstructions, where you don't want the redstone placement to overwrite that certain block.

Let's say that the note blocks you placed down are configured like this:

There are 2 "Piano"s, 1 "Click", 1 "Snare Drum", 1 "Bass Drum", and 2 Obstructing Blocks. In this scenario, Example.txt will look like this:

piano 0 5 -2
piano 0 5 -1
click 0 5 0
snare drum 0 5 1
bass drum 0 5 2
obstructions 0 5 -3
obstructions 0 5 3

You are allowed to configure the note block coordinates and the obstructing blocks however you want, but you need to keep some rules in mind:

• At least 1 side of each note block's face must be kept clear so the note block can be activated; but that same face must not be used by another note block.

• Leave a 2 block gap above and a 1 block gap below a noteblock, so the instrument block can be placed below it and an air gap above it. Above that, an instrument block could be placed if necessary.

Usage

1. Go into the WirelessNBS directory.
2. Copy the NBS file into the same directory as the program.
3. Make sure you have your corresponding .txt file in the same directory as the program.
4. Open console and run the program by doing:

$ python3 nbsToWireless.py

OR: (Skip steps 5 and 6 if you use this method.)

$ python3 nbsToWireless.py <NBS File> <Name Of Datapack>

5. You'll be prompted to input the .nbs file that you're trying to convert. Input that and press 'Enter'.
6. You'll be prompted to input the name of the datapack. Input that and press 'Enter'.
7. Due to recent datapack changes in 1.21, you'll be prompted to respond to whether the function will be used in version 1.21 or above. Respond with "Y" if you will be running it in 1.21+. If not, respond with "N".
8. After it finishes, move the .zip folder to the datapack folder in the world you're using it in.