Advanced Musicbox For NBS

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

- sample songs with full GUI control. - sample songs → Opens a simple play/stop GUI. - sample songs → Opens a GUI to select and receive custom sample songs. - sample songs can be inserted into a sample songs, broadcasting music to sample songs (radio-like area playback). - sample songs → opens a GUI that allows you to purchase music discs for the amount specified in the config. - sample songs - Place a sample songs next to a jukebox → its discs become a sample songs. - Place a sample songs next to it → becomes a sample songs. Right-click while music is playing to open a GUI and: - Switch tracks from the chest playlist - Seek/jump to a specific time - A sample songs attached to the jukebox can also sample songs. - sample songs — 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

- NoteblockAPI Resource Pack - Vanilla Minecraft has a NoteblockAPI Resource Pack. To play songs that exceed this (most samples do), you must: 1. Install the NoteblockAPI Resource Pack 2. Set in `config.yml`: ```yaml 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

- jukebox → Opens main GUI. Click to jukebox instantly. - jukebox → Select a disc → Receive it → Insert into a jukebox to share music with nearby players.

---

🔧 Config

- Includes enable10octave. - enable10octave `en` or `ja` — server-wide language. - enable10octave — playback distance. - enable10octave — automatically stop when no one is listening. - enable10octave — require `musicbox.hear` to listen. - enable10octave — unlock extended octaves with the resource pack.

---

🇯🇵 日本語 — 概要

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

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

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

↓画像付きガイド

---

✨ 主な機能

- 二次配布はご遠慮ください。可能。 - 二次配布はご遠慮ください。 → 再生/停止のGUIを開く。 - 二次配布はご遠慮ください。 → ディスクを選んで入手できるGUIを開く。 - 二次配布はご遠慮ください。 → configで設定された金額でミュージックディスクを購入できるGUIを開きます - 二次配布はご遠慮ください。を 二次配布はご遠慮ください。に入れると、 周囲のプレイヤー全員に 二次配布はご遠慮ください。できます。 - 二次配布はご遠慮ください。 - ジュークボックスの横にある 二次配布はご遠慮ください。 → 中のディスクが 二次配布はご遠慮ください。。 - 横に置いた 二次配布はご遠慮ください。 → リモコンとして機能。 再生中に右クリックするとGUIが開き、 - プレイリスト内の曲切り替え - 特定時間へスキップ が可能。 - ジュークボックスに付けた 二次配布はご遠慮ください。でも曲送り可能。 - 二次配布はご遠慮ください。はサーバー全体で反映。 - J-POP / ボカロ / Undertale / Splatoon などの二次配布はご遠慮ください。。 二次配布はご遠慮ください。 - どの範囲のjukeboxでも、誰にも聞こえない範囲にいる場合は5分後には自動的に消滅します (設定可能) - jukeboxにはソングプレーヤーのコントロールパネルがありますが、ジュークボックス自体をシフト右クリックしても開くことができます。 ---

📦 依存関係・バージョン

- NoteblockAPI用リソースパック - NoteblockAPI用リソースパック - バニラMinecraftには NoteblockAPI用リソースパックがあります。 これを超える曲（サンプルはほぼ超えています）を再生する場合は： 1. NoteblockAPI用リソースパックを導入 2. `config.yml` で以下を設定 ```yaml enable10octave: true ``` 3. すべてのプレイヤーにリソパを適用 これらがない場合、高音・低音が正しく再生されません。

---

🎮 主要コマンド

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

---

🔧 Config

- enable10octave付き。 - enable10octave `en` または `ja`（サーバー全体）。 - enable10octave：再生範囲。 - enable10octave：誰も聞いていなければ自動停止。 - enable10octave：`musicbox.hear` 所持者のみ聞ける設定。 - enable10octave：リソースパック使用時の拡張オクターブを有効化。

---

Enjoy your music in Minecraft! 🎶