Generate music compositions in Minecraft noteblocks
Project description
Noteblock generator
Generate music in Minecraft noteblocks.
This program is only intended for my own use, and shared only for others to replicate my builds.
See my projects:
- Handel's He trusted in God
- Bach's Sind Blitze, sind Donner
- Bach's Herr, unser Herrscher
- Mozart's Confutatis
- Mozart's Dies irae
- Mozart's Sull'aria
Requirements
- Minecraft java 1.19+
- python 3.10+
Installation:
pip install --upgrade noteblock-generator
Do not use git version, it is for development (i.e. myself) only. I cannot guarantee that it is compatible with all of my projects.
Usage
noteblock-generator [-h] [--location [LOCATION ...]] [--orientation [ORIENTATION ...]] [--theme THEME] [--blend] path_in path_out
positional arguments:
path_in path to music source file/folder
path_out path to Minecraft world
options:
-h, --help show this help message and exit
--location [LOCATION ...] build location (in x y z); default is ~ ~ ~
--dimension DIMENSION build dimension; default is player's dimension
--orientation [ORIENTATION ...] build orientation (in x y z); default is + + +
--theme THEME redstone-conductive block; default is stone
--blend blend the structure in with its environment (EXPERIMENTAL)
Path in
Path to a music file, or a folder containing multiple music files.
This program is only intended for my own use, so there is no documentation for writing music files. Follow my Build from source
instructions to replicate my builds.
Path out
Path to a Minecraft world save folder.
Location
The location where the structure will be generated.
This uses Minecraft's relative coordinates syntax, where ~
stands for the player's location. For example, --location ~ ~ ~
(default) is the player's current location, --location ~ ~10 ~
is 10 blocks above the player, etc.
Warning: If you are on a Unix operating system, the character ~
must be escaped (e.g. the above example would be --location \~ ~10 \~
).
Dimension
The dimension where the structure will be generated.
Valid choices are overworld
, the_nether
, the_end
.
If not given, it will be the player's current dimension.
Orientation
In which direction, from the aforementioned location, the structure will be generated.
--orientation + + +
(default) means the structure will be generated towards the positive x, positive y, positive z directions.
All valid orientations are + + +
, + + -
, + - +
, + - -
, - + +
, - + -
, + + +
, + + -
, + - +
, + - -
.
Note: Make sure there is enough space in your specified direction. The program cannot generate below bedrock, or above the height limit, etc. For example,--location 0 -64 0 --orientation + - +
will not work.
Theme
Choose a block that can conduct redstones. Default is stone
.
Consult Minecraft's documentation for what blocks can conduct redstone and their technical names (java version).
Blend
By default, the program will clear the entire space before generating. With --blend
, it will place noteblocks and redstone components where they need to be, remove things that may interfere with the redstones (e.g. water), and leave the rest as-is. The result is the structure will appear blended in with its environment, which in my opinion looks quite nice.
This is an experimental feature. If the redstones and/or noteblocks don't behave as expected, turn it off.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for noteblock_generator-0.1.9.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | a90921725272e3f5c037ebd8991e786e46bd31913782b5fcc4e488ffe77e266d |
|
MD5 | 7c3ed8bd11b57b6d89f8f78ca63a866a |
|
BLAKE2b-256 | 13d762985c4a8c1be281225a32ad18eefde1d4cdb8a852367cb99f7b1d01cf0c |
Hashes for noteblock_generator-0.1.9.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d8ea616690ef5b85a7676c71296a3f3201de229e98c2bdd70699aa03e776fb75 |
|
MD5 | e0f927a0d6257dd4b0d26a9e0eb139bd |
|
BLAKE2b-256 | 4a14939297431f35a6aac3d04e0895334e7f7d3b648611e585db1d544b28f7b1 |