A powerful & user-friendly NBS music player for Spigot/Paper

日本語は画像含め後半にあります

Notice お知らせ

Requires NoteBlockAPI

To bypass the 2-octave limit, you must modify the config settings and install the resource pack distributed on the Noteblock API GitHub! (Primarily server-side)

In the latest version, a known issue with the Noteblock API causes music to playback significantly slower than the intended tempo. Version 1.21.4 did not exhibit this issue, so we recommend using that version.

---

このpluginを使用するにはNoteblock APIが必要です！

2オクターブ制限を無視するには configの設定変更と[Noteblock APIのgithub](https://github.com/koca2000/NoteBlockAPI)で配布されているリソースパックの導入が必要です！(基本サーバー側)

最新バージョンでは、NoteblockAPIの既知の不具合により、想定されたテンポよりも音楽が非常に遅く再生されてしまう事が起きています。1.21.4では不具合は確認されませんでしたのでそちらをおすすめします。

---

Overview (pic guide)

AdvancedMusicBox is a plugin designed to bring Note Block Studio (NBS) music into Minecraft in a smooth and intuitive manner. Through its graphical interface, custom music discs, jukebox broadcasting, and playlist controls using signs, chests, and buttons, the plugin allows players to enjoy high‑quality in-game music with minimal setup. A server‑wide English/Japanese language toggle ensures accessibility for international communities.

Note Block World is recommended for obtaining NBS files.

(Note that many are outside the vocal range)

↓PicGuide

✨Features

• Play NBS songs in-game with full GUI control.
• /musicbox → Opens a simple play/stop GUI.
• /musicbox give → Opens a GUI to select and receive custom MusicBox discs.
• Custom discs can be inserted into a jukebox, broadcasting music to all nearby players (radio-like area playback).
• /musicbox shop → opens a GUI that allows you to purchase music discs for the amount specified in the config.
• Signs + Chests + Buttons integration:
  • Place a chest next to a jukebox → its discs become a playlist.
  • Place a sign next to it → becomes a remote control.
    Right-click while music is playing to open a GUI and:
    • Switch tracks from the chest playlist
    • Seek/jump to a specific time
  • A button attached to the jukebox can also skip tracks.
• Language toggle (EN/JA) — server-wide setting.
• Includes sample songs (J-POP, Vocaloid, Undertale, Splatoon).
• Any range songplayer(sign|jukebox) self-destruct(i mean songplayer, not block) after 5 minutes as no one hears them (configurable)
• Any songplayer has songplayer control panel(Player,jukebox and signs). Shift click to sign or jukebox Plugin include 45 track's!!!!

---

📦Requiements

• Requires NoteBlockAPI
• Vanilla Minecraft has a ~2-octave limit.
  To play songs that exceed this (most samples do), you must:
  1. Install the NoteblockAPI Resource Pack
  2. Set in config.yml:

     enable10octave: true
     

  3. Ensure all players use the resource pack
     Otherwise, high/low notes may sound incorrect.

---

💻️ Version

• Supports Spigot/Paper 1.21 – 1.21.x

---

🎮 Commands / Usage

• /musicbox
  → Opens main GUI. Click to play/stop instantly.
• /musicbox give
  → Select a disc → Receive it → Insert into a jukebox to share music with nearby players.

---

🔧 Config

• Includes bilingual comments (EN/JA).
• lang: en or ja — server-wide language.
• speakerRadius / jukeboxRadius — playback distance.
• autoDestroy — automatically stop when no one is listening.
• hearPermissionsCheck — require musicbox.hear to listen.
• enable10octave — unlock extended octaves with the resource pack.

---

🇯🇵 日本語 — 概要

AdvancedMusicBox は、Note Block Studio（NBS）形式の音楽を Minecraft 内で自然に再生できるようにするためのプラグインです。GUI 操作、カスタムディスク、ジュークボックスでの再生共有、看板・チェスト・ボタンによるプレイリスト管理など、専門的な知識がなくても扱えるよう設計されています。サーバー全体での英語・日本語切り替えにも対応しており、幅広いユーザー環境で使用できます。

NBSのファイルの入手にはNote Block Worldがおすすめです。

(音域範囲外のものも多いため注意)

↓画像付きガイド

---

✨ 主な機能

• NBSファイルをゲーム内で再生可能。
• /musicbox → 再生/停止のGUIを開く。
• /musicbox give → ディスクを選んで入手できるGUIを開く。
• /musicbox shop → configで設定された金額でミュージックディスクを購入できるGUIを開きます
• カスタムディスクを ジュークボックスに入れると、
  周囲のプレイヤー全員に ラジオのように音楽を共有できます。
• 看板・チェスト・ボタン連動：
  • ジュークボックスの横にある チェスト → 中のディスクが プレイリスト化。
  • 横に置いた 看板 → リモコンとして機能。
    再生中に右クリックするとGUIが開き、
    • プレイリスト内の曲切り替え
    • 特定時間へスキップ
      が可能。
  • ジュークボックスに付けた ボタンでも曲送り可能。
• **言語切替（EN/JA）**はサーバー全体で反映。
• J-POP / ボカロ / Undertale / Splatoon などのサンプル曲を同梱。
  二次配布はご遠慮ください。
• どの範囲のjukeboxでも、誰にも聞こえない範囲にいる場合は5分後には自動的に消滅します (設定可能)
• jukeboxにはソングプレーヤーのコントロールパネルがありますが、ジュークボックス自体をシフト右クリックしても開くことができます。

---

📦 依存関係・バージョン

• NoteBlockAPI が必須
• Spigot / Paper 1.21 ～ 1.21.x 対応
• バニラMinecraftには 約2オクターブの制限があります。
  これを超える曲（サンプルはほぼ超えています）を再生する場合は：
  1. NoteblockAPI用リソースパックを導入
  2. config.yml で以下を設定

     enable10octave: true
     

  3. すべてのプレイヤーにリソパを適用
     これらがない場合、高音・低音が正しく再生されません。

---

🎮 主要コマンド

• /musicbox
  → GUIを開き、ワンクリックで再生/停止。
• /musicbox give
  → ディスクを選んで受け取り、ジュークボックスに入れれば周囲に共有再生。

---

🔧 Config

• 英日バイリンガルコメント付き。
• lang: en または ja（サーバー全体）。
• speakerRadius / jukeboxRadius：再生範囲。
• autoDestroy：誰も聞いていなければ自動停止。
• hearPermissionsCheck：musicbox.hear 所持者のみ聞ける設定。
• enable10octave：リソースパック使用時の拡張オクターブを有効化。

---

Enjoy your music in Minecraft! 🎶