?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings

NoteBox

About A powerful Minecraft Spigot/Paper music plugin that plays NBS (Note Block Studio) format songs

67
2
67
2

Compatibility

Minecraft: Java Edition

26.1.x
1.21.x
1.20.x
1.19.x
1.18.x
1.17.x
1.16.x
1.15.x
1.14.x
1.13.x

Platforms

Links

Report issues View source Visit wiki

Tags

Creators

Details

Licensed MIT
Published last month

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

  1. Download NoteBox-x.x.x.jar from the Releases page.
  2. Place the JAR file in your server's plugins/ directory.
  3. Restart your server.
  4. Place .nbs song files in plugins/NoteBox/songs/.
  5. Run /notebox reload to load all songs.
  6. Use /notebox to 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_