Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
PaperBlockTuner
PaperBlockTuner is a Minecraft plugin for Paper and downstream servers that allows players to interactively edit note blocks using command and tool item.
Features
- Tune note blocks using command and a stick
- Change instruments via GUI
- Scroll-tuning support for blocks and items
- Configurable settings per-player
- Support BlockTuner mod
Getting Started
Requirements
- Minecraft 1.20.5+
- Paper and downstream server
- Java 21+
- Gradle (for building from source)
Installation
- Download the plugin JAR (or build it yourself, see below).
- Place it in the
plugins/directory of your Paper server. - Restart the server.
- Configuration and data will be generated automatically.
Building From Source
./gradlew build
The resulting .jar will be located in build/libs/.
Usage
Commands
| Command | Description | Permission |
|---|---|---|
/blocktuner |
Opens the main menu / settings GUI. | blocktuner.command.base |
/blocktuner reload |
Reload the plugin. | blocktuner.admin |
/blocktuner settings |
Opens the tuning settings GUI. | blocktuner.command.settings |
/tune |
Tunes the block or item the player is aiming. | blocktuner.command.tune |
/tunehand |
Tunes the block or item the player is holding. | blocktuner.command.tunehand |
/tunestick |
Get a stick for interactive tune (right/left click). | blocktuner.command.tunestick |
Permissions
| Permission | Description |
|---|---|
blocktuner.command.base |
Allows access to the main /blocktuner command. |
blocktuner.command.settings |
Grants access to open the settings GUI. |
blocktuner.command.tune |
Allows use of the /tune command to open the note tuning GUI. |
blocktuner.command.tunehand |
Allows use of /tunehand to tune the item/block in hand. |
blocktuner.command.tunestick |
Allows get a tuning a stick for interactive tuning (left/right-click). |
blocktuner.settings.note-tuning |
Allows toggling note tuning in the settings GUI. |
blocktuner.settings.instrument-tuning |
Allows toggling instrument tuning in the settings GUI. |
blocktuner.settings.scroll-item |
Allows enabling scroll-wheel tuning for held items. |
blocktuner.settings.scroll-block |
Allows enabling scroll-wheel tuning for blocks. |
blocktuner.settings.sync-instrument |
Allows enabling sync of block instrument type when tuning. |
blocktuner.playnote |
Allows a player to trigger note playback (used during tuning). |
blocktuner.edit |
General edit permission for tuning actions. |
blocktuner.admin |
Grants access to administrative features and full control over plugin actions. |
GUI
(All names are configurable)
License
This project is licensed under the MIT License. See the LICENSE file for details.
Pinned Versions
Members
Owner