📻 PoliceRadio

By @k3yzzonly_

Bring realistic tactical radio communication to your Minecraft roleplay server.

PoliceRadio is a rank-restricted police radio plugin for Paper servers, powered by Simple Voice Chat. It introduces an immersive walkie-talkie communication system designed specifically for police, SWAT, emergency services, and government roleplay environments.

With private tactical channels, configurable rank restrictions, realistic radio audio effects, and powerful administrative controls, PoliceRadio makes in-character communication more immersive, organized, and secure.

Players without the required permissions or Police rank cannot access the radio network, view restricted channels, or listen to private radio conversations.

✨ Features

• 🔒 Rank-Based Access Control — Restrict radio access to players with a configurable rank prefix. By default, only players with the Police rank can use the radio system.

• 📻 Tactical Radio Channels — Includes 10 dedicated tactical frequencies (TAC.1 – TAC.10), each connected to its own private and hidden Simple Voice Chat group.

• 🛡️ Private & Secure Communication — Radio channels are hidden and access-restricted, preventing unauthorized players from joining or listening to tactical conversations.

• 🔄 Seamless Frequency Switching — Switch between channels with a built-in 1-second cooldown, accompanied by immersive on-screen titles and sound feedback.

• 🎙️ Realistic Walkie-Talkie Audio — Built-in band-pass filtering and noise-gate processing create a radio-style voice experience, enhanced with authentic push-to-talk clicks and radio static effects.

• 📊 Live Radio HUD — Displays the player's currently selected frequency through a scoreboard indicator (Radio Ch: TAC.X), visible only to eligible Police players.

• 🛠️ Advanced Admin Configuration — Manage radio channels, rank requirements, communication radius, sound effects, and plugin messages directly through /pradio settings, with changes applied without restarting the server.

• 🔗 Plugin Integrations — Designed to work seamlessly with LuckPerms, PlaceholderAPI, and Simple Voice Chat.

• 🔔 Automatic Update Checker — Notifies server administrators in-game and through the console whenever a newer version of PoliceRadio is available.

🎮 Commands

Command	Description
/pradio	Opens the main PoliceRadio interface.
/pradio settings	Opens the administrative settings menu.

🔐 Permissions

PoliceRadio includes a flexible permission system, allowing server owners to manage access using LuckPerms or other permission management plugins.

Permission	Description
policeradio.admin	Grants full administrative access to all PoliceRadio features and commands.
policeradio.settings	Allows access to and management of PoliceRadio settings.
policeradio.use	Allows players to use the PoliceRadio system.
policeradio.bypass	Bypasses general PoliceRadio restrictions.
policeradio.bypass.rank	Bypasses rank-based access restrictions.
policeradio.channel	Allows players to access and use radio channels.
policeradio.channel.*	Grants access to all available PoliceRadio channels.

Permission Management: Permissions can be assigned individually or through a permission management plugin such as LuckPerms.

⚙️ Requirements

• Server Software: Paper
• Minecraft Version: 1.20+
• Voice Chat: Simple Voice Chat (Required)
• Recommended: LuckPerms
• Optional: PlaceholderAPI

🎧 Recommended Voice Settings

For the best experience, using Push-to-Talk (PTT) is highly recommended when playing with PoliceRadio. It provides better control over radio transmissions and helps prevent unwanted background noise from interfering with tactical communications.

PoliceRadio also features dedicated radio transmission sound effects (SFX):

• 🎙️ Transmission Start SFX — Plays a sound effect when a player starts speaking over the radio.
• 📻 Transmission End SFX — Plays a sound effect when a player finishes speaking, recreating the authentic feel of a real walkie-talkie transmission.

These audio effects make every radio interaction feel more immersive and realistic, bringing your server's police roleplay experience to the next level.

🚔 Built for Roleplay

Whether you're running a professional police department, a tactical SWAT unit, or an entire government roleplay organization, PoliceRadio provides the communication infrastructure needed to make your roleplay experience feel more authentic.

Stay connected. Stay coordinated. Keep the frequency secure.

---

_{Developed with ❤️ by k3yzzonly_}