📻 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 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

1. Install NoteBlockAPI — 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 OpenNBS editor)