LibertyVoiceBans 🎙️🚫

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.

✨ Features

• Real-time Synchronization: Instantly mutes a player's microphone the moment they are punished.
• Smart Auto-Unmute: Continuously checks for temporary mute expirations in the background and restores voice chat seamlessly.
• Dual Architecture Support: 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-Velocity.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 Velocity 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:

# 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

• Players are muted in text but can still speak in voice chat:
  • 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.