SIXsVCMute

SIXsVCMute is a moderation plugin for Simple Voice Chat that gives server staff full control over voice channel access — mute, ban, and IP-ban players directly from Voice Chat, with support for temporary and permanent punishments, reasons, and a complete history log.

---

✨ Features

• 🔇 VC Mute — Silences a player in Voice Chat. They remain connected but can't be heard.
• 🚫 VC Ban — Kicks and blocks a player from connecting to Voice Chat entirely.
• 🌐 VC IP Ban — Bans a player's IP from Voice Chat, blocking ban evasion attempts.
• ⏱️ Temporary or Permanent Punishments — Specify a duration (30s, 10m, 2h, 7d, or combinations like 1h30m) or leave it out for a permanent sanction.
• 📋 Reason Support — Attach a reason to every punishment, shown to the target and logged in history.
• 📜 Punishment History — Full per-player history of all VC sanctions with /vc history <player>.
• 📊 Status & List — Check a player's current VC status (/vc player) or list all active mutes/bans (/vc list).
• 🔔 Admin Notifications — Admins are notified when a muted/banned player joins the server.
• 💾 Persistent Data — All punishments survive server restarts.
• 🎨 Fully Customizable Messages — Every message is editable in config.yml, with full support for & color codes and hex colors (&#RRGGBB).
• 🔁 Hot Reload — Apply config changes live with /vc reload, no restart needed.

---

📦 Requirements

• Paper / Purpur (API 1.21+)
• Simple Voice Chat (soft dependency — plugin loads without it, but VC features require it)

---

🛠️ Commands

| Command | Description |
|---|---|
| /vcmute <player> [duration] [reason] | Mute a player from VC |
| /vcunmute <player> | Remove a VC mute |
| /vcban <player> [duration] [reason] | Ban a player from VC |
| /vcunban <player> | Remove a VC ban |
| /vcbanip <player> [duration] [reason] | IP-ban a player from VC |
| /vcunbanip <player\|ip> | Remove a VC IP ban |
| /vc help | Show command list |
| /vc status | Show plugin status |
| /vc player <player> | Show a player's VC status |
| /vc list | List all active mutes and bans |
| /vc history <player> | Show sanction history for a player |
| /vc reload | Reload the configuration |

---

🔐 Permissions

| Permission | Description | Default |
|---|---|---|
| vcmoderator.* | All SIXsVCMute permissions | false |
| vcmoderator.mute | /vcmute and /vcunmute | op |
| vcmoderator.ban | /vcban and /vcunban | op |
| vcmoderator.banip | /vcbanip and /vcunbanip | op |
| vcmoderator.status | /vc status | op |
| vcmoderator.list | /vc list | op |
| vcmoderator.history | /vc history | op |
| vcmoderator.reload | /vc reload | op |
| vcmoderator.bypass | Cannot be muted or banned | false |

---

⚙️ Configuration

All plugin messages are fully customizable in config.yml. Supports & color codes and hex colors (&#RRGGBB). Change the prefix, default reasons, and every single notification message to match your server's style.

---

🐛 Bug Reports & Support

Got a bug? A question? Just want to know what's coming next? The Discord server is the place to be — support tickets, changelogs, announcements and more, all in one place.

👉 Join the Discord

---

Made by SIXs — built for 1.21+