📻 PolaRadio — Server-Wide NoteBlock Radio
Turn your server into a 24/7 radio station. PolaRadio streams
.nbsnote block songs to everyone online on a looping playlist — with per-player mute, personal volume, an in-game song-picker GUI, and full DJ controls.
Built on NoteBlockAPI for authentic in-game note block music.
✨ Features
- 🎶 Server-wide broadcast — one shared radio stream plays to all online players at once.
- 🔁 Auto playlist — songs play back-to-back and loop forever; choose LOOP or SHUFFLE order.
- 🔇 Per-player opt-out — anyone can mute the radio just for themselves with
/radio toggle. Saved between sessions. - 🔊 Per-player volume — each player sets their own listening volume from 0–100.
- 🖥️ Song-picker GUI — a clean paginated menu showing every loaded song; the now-playing track is highlighted.
- 🎛️ DJ controls — force-play, skip, stop/start, view now-playing, and switch playlist modes.
- 📢 Now-playing announcements — shown in the action bar or chat (configurable), automatically skipped for muted players.
- ♻️ Live reload — add new songs and reload instantly, no restart needed.
- ⌨️ Full tab-completion on every sub-command, mode, volume preset, and song name.
- 🎨 Fully configurable messages & colors.
📥 Installation
- Install NoteBlockAPI — drop
NoteBlockAPI.jarinto yourplugins/folder. (Required — PolaRadio won't start without it.) - Drop
PolaRadio.jarintoplugins/. - Start the server once to generate the config and the
plugins/PolaRadio/songs/folder. - Put your
.nbssong files intoplugins/PolaRadio/songs/. - Run
/radio reload(or restart) — the radio starts automatically. 🎉
🎮 Commands
Main command: /radio (alias /r)
| Command | Permission | Description |
|---|---|---|
/radio or /radio gui |
polaradio.use |
Open the song-picker GUI |
/radio toggle |
polaradio.use |
Mute/unmute the radio for yourself |
/radio volume <0-100> |
polaradio.use |
Set your personal volume |
/radio nowplaying |
polaradio.use |
Show the current song |
/radio play <name/#> |
polaradio.dj |
Force-play a song server-wide |
/radio next |
polaradio.dj |
Skip to the next song |
/radio stop |
polaradio.dj |
Stop / start the radio |
/radio mode <loop|shuffle> |
polaradio.dj |
Set the playlist mode |
/radio reload |
polaradio.admin |
Rescan songs & reload config |
🔑 Permissions
| Permission | Default | Grants |
|---|---|---|
polaradio.use |
everyone | Listen, toggle, volume, GUI, now-playing |
polaradio.dj |
op | Playback control (play/next/stop/mode) |
polaradio.admin |
op | Reload the plugin |
polaradio.* |
op | All of the above |
⚙️ Configuration
Everything is configurable in config.yml — default volume, playlist mode, auto-start, announcement style (action bar vs chat), and all messages/colors. Per-player preferences (mute + volume) are stored in players.yml.
📋 Requirements
- Server: Paper / Spigot
- Dependency: NoteBlockAPI (required)
- Songs:
.nbsfiles (create them with the OpenNBS editor)
