Turns a .nbs file into a Wireless Noteblock Piece via datapack.
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.
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.
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.
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.
- Go into the
WirelessNBS
directory. - Copy the NBS file into the same directory as the program.
- Make sure you have your corresponding
.txt
file in the same directory as the program. - 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>
- You'll be prompted to input the .nbs file that you're trying to convert. Input that and press 'Enter'.
- You'll be prompted to input the name of the datapack. Input that and press 'Enter'.
- 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".
- After it finishes, move the .zip folder to the datapack folder in the world you're using it in.