Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for Lumine1909
Avatar for Lumine1909
Lumine1909 /

PaperBlockTuner

Minecraft Note Block Tuning Plugin

Download External
Paper1.20.5-1.21.4

Report PaperBlockTuner?

PaperBlockTuner

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

  1. Download the plugin JAR (or build it yourself, see below).
  2. Place it in the plugins/ directory of your Paper server.
  3. Restart the server.
  4. 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)

image

image

image

License

This project is licensed under the MIT License. See the LICENSE file for details.

Information

Category
Admin Tools
Published
April 13, 2025
License
MIT
6Downloads
0Stars

Pinned Versions

Pages

Members

1