# LibertyVoiceBans \ud83c\udf99\ufe0f\ud83d\udeab<\/p>\n
**LibertyVoiceBans** is a bridge plugin that connects LibertyBans with Simple Voice Chat. 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.<\/p>\n
## \u2728 Features
\n* **Real-time Synchronization:** Instantly mutes a player’s microphone the moment they are punished.
\n* **Smart Auto-Unmute:** Continuously checks for temporary mute expirations in the background and restores voice chat seamlessly.
\n* **Dual Architecture Support:** Works natively on single standalone servers AND large proxy networks (Velocity + Backend).
\n* **Anti-Spam Warning:** Sends a customizable cooldown-protected chat message to muted players when they try to speak.<\/p>\n
—<\/p>\n
## \ud83c\udfd7\ufe0f How It Works (Modes)<\/p>\n
LibertyVoiceBans features a smart configuration system with two modes to fit any server architecture.<\/p>\n
### 1. Proxy Mode (Recommended for Networks)
\nIf your server uses a proxy (Velocity) and LibertyBans is installed on the proxy, this mode is for you.
\n* **LibertyVoiceBans-Velocity.jar** is installed on the proxy. It listens to LibertyBans events globally.
\n* **LibertyVoiceBans-Bukkit.jar** is installed on your backend game servers (Paper\/Spigot). It waits for invisible Plugin Messages from Velocity.
\n* *Advantage:* You don’t even need to install LibertyBans on your backend servers. Zero database desync issues!<\/p>\n
### 2. Standalone Mode (For Single Servers)
\nIf you don’t use a proxy and only have a single Paper\/Spigot server, this mode is for you.
\n* **LibertyVoiceBans-Bukkit.jar** hooks directly into the local LibertyBans installation on the same server.
\n* *Advantage:* Simple plug-and-play setup for small servers.<\/p>\n
—<\/p>\n
## \ud83d\udce5 Installation & Setup<\/p>\n
### \u2699\ufe0f Setup A: Proxy Networks (Velocity + Paper\/Bukkit)
\n1. Drop `LibertyVoiceBans-Velocity.jar` into your **Velocity** `plugins` folder.
\n2. Drop `LibertyVoiceBans-Bukkit.jar` into your **Backend Server** (Paper\/Bukkit) `plugins` folder.
\n3. Restart all servers.
\n4. The backend server will generate a `config.yml`. Make sure `mode` is set to `’proxy’`.
\n5. *(Optional)* You can safely delete LibertyBans from your backend servers if you only use it for punishments on the proxy.<\/p>\n
### \u2699\ufe0f Setup B: Standalone Servers (Paper\/Bukkit Only)
\n1. Ensure both `LibertyBans` and `Simple Voice Chat` are installed on your server.
\n2. Drop `LibertyVoiceBans-Bukkit.jar` into your server’s `plugins` folder.
\n3. Restart the server.
\n4. Open `plugins\/LibertyVoiceBans\/config.yml`.
\n5. Change `mode: ‘proxy’` to **`mode: ‘standalone’`**.
\n6. Restart the server one last time.<\/p>\n
—<\/p>\n
## \ud83d\udcdd Configuration (`config.yml`)<\/p>\n
The Bukkit plugin generates a highly customizable config file:<\/p>\n
“`yaml
\n# LibertyVoiceBans – Bukkit Configuration<\/p>\n
# Choose the operation mode:
\n#
\n# ‘proxy’ -> (Recommended) Punishments are tracked via the Velocity plugin.
\n# LibertyBans is NOT required on this specific backend server.
\n# ‘standalone’ -> Punishments are tracked via the local LibertyBans installation.
\n# LibertyBans is STRICTLY REQUIRED on this server.
\nmode: ‘proxy’<\/p>\n
messages:
\n prefix: ‘&8[&cLibertyVoice&8] ‘
\n muted-warning: ‘&cYou cannot use voice chat because you are muted in text chat!’<\/p>\n
settings:
\n # The cooldown (in seconds) for sending the warning message.
\n # Voice chat sends hundreds of packets per second. This prevents chat spam.
\n warning-cooldown: 5
\n“`<\/p>\n
### Tips for Translators
\nYou can fully translate the `prefix` and `muted-warning` fields. Standard Minecraft color codes (`&c`, `&8`, etc.) are fully supported.<\/p>\n
—<\/p>\n
## \ud83c\udd98 Troubleshooting
\n* **Players are muted in text but can still speak in voice chat:**
\n * If using *Proxy Mode*, ensure the proxy and backend servers can communicate via Plugin Messaging.
\n * If using *Standalone Mode*, verify that the local LibertyBans database contains the active punishment.
\n* **Plugin fails to load on backend server:**
\n * Ensure `Simple Voice Chat` is installed. LibertyVoiceBans requires VoiceChat API to function.<\/p>\n","protected":false},"excerpt":{"rendered":"
This plugin adds compatibility between LibertyBans and Simple Voice Chat for muting players in voice chat.<\/p>\n","protected":false},"featured_media":93544,"template":"","meta":{"_minecraft_slug":"libertyvoicebans","_minecraft_project_id":"klRMKsxN","_minecraft_author":"YusufKGD","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":10,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"libertyvoicebans.zip","_minecraft_size_bytes":15481,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T23:07:21.322396Z","_minecraft_date_created":"2026-05-11T02:25:45.961694Z","_minecraft_date_modified":"2026-05-09T23:33:11.678381Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/libertyvoicebans","_minecraft_icon_attachment_id":93544,"_minecraft_imported_at":"2026-06-05T08:23:38+00:00","_minecraft_import_hash":"21c2cbdd2942f74f36f7ed46bfaf26d9","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,126,127,128,867,129,92,985],"mod_loader":[130,132,133,134],"minecraft_version":[40,41,38,78,79,80,81,82,83,167,163],"class_list":["post-93543","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_category-velocity","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n