NoteBox
A powerful NBS music plugin for Spigot/Paper servers. Plays Note Block Studio format songs with a built-in audio engine -- no external dependencies required.
Features
- NBS Song Playback - Play Note Block Studio format music files seamlessly
- Radio Mode - Listen privately (only you can hear)
- Speaker Mode - Broadcast music to nearby players
- Music Signs - Redstone-triggered music playback
- Jukebox Integration - Right-click jukeboxes to open the music GUI
- GUI Browser - Intuitive graphical interface for browsing songs
- Playlists - Create and manage personal playlists
- Disc Shop - Economy-powered music disc store (Vault support)
- Song Search - Search songs by keyword
- Song Request - Request songs with configurable cooldown
- Volume Control - Per-player volume adjustment (0-100)
- Loop Modes - None, Single, All, Shuffle
- Particle Effects - Visual effects synchronized with music
- Region Music - Auto-play music in WorldGuard regions
- PlaceholderAPI - Placeholder support for other plugins
- Multi-language - Chinese, English, Russian
- Permission System - Granular permission control
- Self-contained - Built-in NBS parser and sequencer, no NoteBlockAPI needed
Commands
| Command | Description | Permission |
|---|---|---|
/notebox |
Open the music GUI | notebox.use |
/notebox play <song> |
Play a song | notebox.use |
/notebox silent [player] |
Toggle silent mode | notebox.use |
/notebox stop |
Stop current playback | notebox.use |
/notebox next |
Skip to next song | notebox.use |
/notebox volume <0-100> |
Set personal volume | notebox.use |
/notebox loop |
Cycle loop mode | notebox.use |
/notebox search <query> |
Search songs | notebox.use |
/notebox request <song> |
Request a song | notebox.request |
/notebox particles |
Toggle particle effects | notebox.use |
/notebox shop [player] |
Open disc shop | notebox.shop |
/notebox give <player> <song> |
Give a music disc | notebox.get |
/notebox reload |
Reload configuration | notebox.admin |
/notebox shutup |
Stop all music | notebox.admin |
Permissions
| Permission | Description | Default |
|---|---|---|
notebox.use |
Use /notebox command | All players |
notebox.speaker |
Use speaker mode | All players |
notebox.shop |
Access disc shop | All players |
notebox.shop.other |
Open shop for others | Operators |
notebox.get |
Get any music disc | Operators |
notebox.request |
Use song request | All players |
notebox.sign |
Create music signs | All players |
notebox.hear |
Hear music (when check enabled) | All players |
notebox.admin |
Reload and manage music | Operators |
Installation
- Download
NoteBox-x.x.x.jarfrom the Releases page. - Place the JAR file in your server's
plugins/directory. - Restart your server.
- Place
.nbssong files inplugins/NoteBox/songs/. - Run
/notebox reloadto load all songs. - Use
/noteboxto start listening.
Requirements
| Dependency | Type | Required |
|---|---|---|
| Spigot/Paper 1.13+ | API | Yes |
| Vault | Plugin | No (economy) |
| PlaceholderAPI | Plugin | No (placeholders) |
| WorldGuard | Plugin | No (region music) |
Configuration
# Language (zh, en, ru)
lang: zh
# Speaker mode range (blocks)
speakerRadius: 10
# Jukebox range (blocks)
jukeboxRadius: 64
# Economy settings
economy:
enable: true
price: 500
# BossBar display
bossbar:
enable: true
color: GREEN
style: SEGMENTED_20
# Auto-destroy idle players (seconds, 0 = disable)
autoDestroy: 60
# Default player volume (0-100)
defaultVolume: 100
# Song request cooldown (seconds)
request:
enable: true
cooldown: 30
# Particle effects
particles:
enable: true
style: note
Full configuration guide: Configuration Reference
Technical Notes
NoteBox includes a complete NBS file parser and sequencing engine integrated directly into the plugin. No additional NoteBlockAPI installation is needed. The plugin also provides a public API for addon developers.
GitHub: https://github.com/ALingqing/NoteBox Author: ALingqing_
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.13, 1.13.1, 1.13.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
Verified by MCModsHub
- Ships as NoteBox-1.0.0.jar — drop this file into the mods folder
- Download size: 173 KB
- Download link checked 11 Sept 2026 — working
These come from our own check of the pack file, not from the source page.