PolaRadio

# 📻 PolaRadio — Server-Wide NoteBlock Radio > Turn your server into a 24/7 radio station. PolaRadio streams `.nbs` note 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 **(https://www.spigotmc.org/resources/noteblockapi.19287/)** 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 1. Install **(https://www.spigotmc.org/resources/noteblockapi.19287/)** — drop `NoteBlockAPI.jar` into your `plugins/` folder. *(Required — PolaRadio won't start without it.)* 2. Drop **`PolaRadio.jar`** into `plugins/`. 3. Start the server once to generate the config and the `plugins/PolaRadio/songs/` folder. 4. Put your `.nbs` song files into `plugins/PolaRadio/songs/`. 5. 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:** `.nbs` files (create them with the (https://opennbs.org/))