🎙️ VoiceMuteUniversal — Voice Chat Moderation for Minecraft

🇧🇷 Português (PT-BR)

VoiceMuteUniversal é um plugin desenvolvido para facilitar a moderação do chat de voz em servidores Minecraft, permitindo que administradores e moderadores silenciem jogadores de maneira rápida, simples e eficiente.

O plugin utiliza integração com Simple Voice Chat e LuckPerms, permitindo controlar a permissão voicechat.speak para impedir ou liberar a transmissão de voz dos jogadores.

✨ Funcionalidades

• 🎤 Mute de voz: impeça jogadores de transmitir áudio.
• ⏳ Mute temporário: silencie jogadores por um período determinado.
• 🔒 Mute permanente: mantenha jogadores silenciados até a remoção manual.
• 🔊 Unmute: libere novamente o microfone dos jogadores.
• 🛡️ Integração com LuckPerms: controle automático da permissão voicechat.speak.
• 💾 Persistência: os mutes são salvos mesmo após reiniciar o servidor.
• 📋 Lista de mutes: visualize jogadores silenciados.
• ⚙️ Configuração personalizável: adapte as mensagens do plugin.

🎮 Comandos

Comando	Descrição
/voicemute <jogador> <tempo> <motivo>	Silencia o jogador pelo tempo informado.
/voicemute <jogador> perma	Silencia permanentemente.
/voiceunmute <jogador>	Remove o mute de voz.
/voicemutelist	Lista jogadores silenciados.

Permissão administrativa: voicemute.admin

🔧 Compatibilidade

• Minecraft: 1.20+
• Servidores: Spigot, Paper, Purpur e Folia
• Java: 17+ (Java 21 nas versões recentes do Minecraft)
• Dependências obrigatórias: LuckPerms e Simple Voice Chat

A compatibilidade com todas as versões e plataformas anunciadas ainda precisa ser validada em testes.

🔐 Como funciona?

Quando um administrador utiliza o comando /voicemute, o plugin altera automaticamente a permissão do jogador através do LuckPerms.

Mutar:

/lp user <jogador> permission set voicechat.speak false

Desmutar:

/lp user <jogador> permission set voicechat.speak true

O VoiceMuteUniversal foi criado para oferecer uma ferramenta prática de moderação por voz, sem necessidade de executar manualmente os comandos do LuckPerms.

🚀 Instalação

1. Instale o LuckPerms e o Simple Voice Chat.
2. Coloque o arquivo .jar do VoiceMuteUniversal na pasta plugins.
3. Reinicie o servidor.
4. Configure as permissões da equipe e comece a moderar!

🎙️ VoiceMuteUniversal — Mais controle, organização e segurança para o chat de voz do seu servidor!

---

🇺🇸 English (EN-US)

VoiceMuteUniversal is a Minecraft plugin designed to make voice chat moderation easier, allowing server administrators and moderators to mute players quickly, easily, and efficiently.

The plugin integrates with Simple Voice Chat and LuckPerms, using the voicechat.speak permission to control whether players can transmit voice audio.

✨ Features

• 🎤 Voice Mute: prevent players from transmitting voice audio.
• ⏳ Temporary Mutes: mute players for a specified duration.
• 🔒 Permanent Mutes: keep players muted until manually unmuted.
• 🔊 Unmute: restore a player's ability to speak in voice chat.
• 🛡️ LuckPerms Integration: automatically manage the voicechat.speak permission.
• 💾 Persistent Mutes: mute records are saved and preserved across server restarts.
• 📋 Mute List: view all currently muted players.
• ⚙️ Customizable Configuration: personalize plugin messages.

🎮 Commands

Command	Description
/voicemute <player> <duration> <reason>	Mutes a player for the specified duration.
/voicemute <player> perma	Permanently mutes a player.
/voiceunmute <player>	Removes a player's voice mute.
/voicemutelist	Displays the list of muted players.

Administrator Permission: voicemute.admin

🔧 Compatibility

• Minecraft: 1.20+
• Server Software: Spigot, Paper, Purpur, and Folia
• Java: 17+ (Java 21 required for newer Minecraft versions)
• Required Dependencies: LuckPerms and Simple Voice Chat

Compatibility across all listed Minecraft versions and server platforms has not yet been fully tested.

🔐 How Does It Work?

When an administrator uses /voicemute, the plugin automatically updates the player's permission through LuckPerms.

Mute a player:

/lp user <player> permission set voicechat.speak false

Unmute a player:

/lp user <player> permission set voicechat.speak true

VoiceMuteUniversal was created to provide a simple and practical voice moderation solution without requiring staff members to manually execute LuckPerms commands.

🚀 Installation

1. Install LuckPerms and Simple Voice Chat on your server.
2. Place the VoiceMuteUniversal .jar file in your server's plugins folder.
3. Restart your server.
4. Configure staff permissions and start moderating!

🎙️ VoiceMuteUniversal — Better control, organization, and safety for your Minecraft server's voice chat!