LibertyVoiceBans

LibertyVoiceBans 🎙️🚫

LibertyVoiceBans is a bridge plugin that connects LibertyVoiceBans with %%MD1%%. When a player is muted via LibertyBans, their voice chat is automatically disabled, and they cannot speak in-game until their mute expires or is pardoned.

✨ Features

* Anti-Spam Warning: Instantly mutes a player's microphone the moment they are punished. * Anti-Spam Warning: Continuously checks for temporary mute expirations in the background and restores voice chat seamlessly. * Anti-Spam Warning: Works natively on single standalone servers AND large proxy networks (Velocity + Backend). * Anti-Spam Warning: Sends a customizable cooldown-protected chat message to muted players when they try to speak.

---

🏗️ How It Works (Modes)

LibertyVoiceBans features a smart configuration system with two modes to fit any server architecture.

1. Proxy Mode (Recommended for Networks)

If your server uses a proxy (Velocity) and LibertyBans is installed on the proxy, this mode is for you. * LibertyVoiceBans-Bukkit.jar is installed on the proxy. It listens to LibertyBans events globally. * LibertyVoiceBans-Bukkit.jar is installed on your backend game servers (Paper/Spigot). It waits for invisible Plugin Messages from Velocity. * *Advantage:* You don't even need to install LibertyBans on your backend servers. Zero database desync issues!

2. Standalone Mode (For Single Servers)

If you don't use a proxy and only have a single Paper/Spigot server, this mode is for you. * LibertyVoiceBans-Bukkit.jar hooks directly into the local LibertyBans installation on the same server. * *Advantage:* Simple plug-and-play setup for small servers.

---

📥 Installation & Setup

⚙️ Setup A: Proxy Networks (Velocity + Paper/Bukkit)

1. Drop `LibertyVoiceBans-Velocity.jar` into your Backend Server `plugins` folder. 2. Drop `LibertyVoiceBans-Bukkit.jar` into your Backend Server (Paper/Bukkit) `plugins` folder. 3. Restart all servers. 4. The backend server will generate a `config.yml`. Make sure `mode` is set to `'proxy'`. 5. *(Optional)* You can safely delete LibertyBans from your backend servers if you only use it for punishments on the proxy.

⚙️ Setup B: Standalone Servers (Paper/Bukkit Only)

1. Ensure both `LibertyBans` and `Simple Voice Chat` are installed on your server. 2. Drop `LibertyVoiceBans-Bukkit.jar` into your server's `plugins` folder. 3. Restart the server. 4. Open `plugins/LibertyVoiceBans/config.yml`. 5. Change `mode: 'proxy'` to `mode: 'standalone'`. 6. Restart the server one last time.

---

📝 Configuration (`config.yml`)

The Bukkit plugin generates a highly customizable config file:

```yaml

LibertyVoiceBans - Bukkit Configuration

Choose the operation mode:

#

'proxy' -> (Recommended) Punishments are tracked via the Velocity plugin.

LibertyBans is NOT required on this specific backend server.

'standalone' -> Punishments are tracked via the local LibertyBans installation.

LibertyBans is STRICTLY REQUIRED on this server.

mode: 'proxy'

messages: prefix: '&8[&cLibertyVoice&8] ' muted-warning: '&cYou cannot use voice chat because you are muted in text chat!'

settings:

The cooldown (in seconds) for sending the warning message.

Voice chat sends hundreds of packets per second. This prevents chat spam.

warning-cooldown: 5 ```

Tips for Translators

You can fully translate the `prefix` and `muted-warning` fields. Standard Minecraft color codes (`&c`, `&8`, etc.) are fully supported.

---

🆘 Troubleshooting

* Plugin fails to load on backend server: * If using *Proxy Mode*, ensure the proxy and backend servers can communicate via Plugin Messaging. * If using *Standalone Mode*, verify that the local LibertyBans database contains the active punishment. * Plugin fails to load on backend server: * Ensure `Simple Voice Chat` is installed. LibertyVoiceBans requires VoiceChat API to function.