NoteBox

# 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 ` | 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 ` | 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 (https://github.com/ALingqing/NoteBox/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 ```yaml # 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: (https://github.com/ALingqing/NoteBox/blob/main/docs/CONFIGURATION.md) ## 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_