🎙️ VoiceServer – Powerful Group Management for Simple Voice Chat

VoiceServer is a lightweight yet advanced plugin that makes managing Simple Voice Chat groups effortless. With intuitive commands offering full tab completion, you can organize, secure, and monitor voice chat groups in real time — perfect for servers hosting events, teams, or dynamic player structures.

Fully compatible with Folia, Paper, Spigot and Bukkit, supporting Minecraft versions from 1.8.8 up to 1.21.x.

Open Source: https://github.com/Jakomi1/VoiceServer

---

🚀 Key Features

• 📋 List all voice chat groups
  View all active Simple Voice Chat groups, including those with password protection. Groups with passwords show [locked] instead of revealing the password.
• 🆕 Create new groups with optional persistence or password protection
  Groups can be created as persistent or non-persistent. Persistent groups may optionally be secured with a password.
• 🧑‍🤝‍🧑 Join players to existing groups
  The join command supports selectors like @a, @s, @r, and @p. The internal playerGroupMap ensures group state consistency.
• ❌ Remove players from groups
  Players can be removed from their current group using selectors. The kick subcommand no longer requires an explicit group argument.
• 🗑️ Safely delete groups
  Non-persistent groups are automatically deleted when empty. Persistent groups remain until manually removed.
• 🛡️ Access control via permissions
  All group management commands are protected by voicechat.group.manage.
• ⚡ Full tab completion support
  Commands, players, selectors, group names, and quoted arguments support Folia-safe tab completion.
• 📌 Persistent groups
  Persistent groups remain available even after all members leave, making them ideal for staff, admin, or permanent team channels.
• 🔁 Persistent groups across restarts (optional)
  A new configuration option persistent-groups-should-survive-restart allows persistent groups to survive restarts or reloads (default: false).
• ➖ Create empty groups
  Using @null with /vcgroup create allows creating a group without any players initially.
• 🐞 Debug logging and safe error handling
  Clear messages and robust error handling ensure high stability.
• ℹ️ /vcgroup info command
  Displays the group type, persistence, lock status, and current members.
• ⚙️ Automatic handling of empty non-persistent groups
  Non-persistent groups are removed automatically when the last player leaves.
• 🔧 Per-player VoiceChat permission system (/vcpermission)
  Fully custom per-player permission management for Simple Voice Chat:
  • listen — listen in voice chat
  • speak — speak in voice chat
  • group — create or join voice groups
  Permissions support give, remove, default, and reset, are stored in config.yml, survive restarts, and are applied live.
• ✅ Fixed /vcpermission command
  The permission system is now fully functional and reliably enforced.
• 🔌 Broad platform compatibility
  Fully compatible with Bukkit, Spigot, Paper, and Folia from Minecraft 1.8.8 up to 1.21.x.

---

🧭 Commands

/vcgroup list

Lists all voice chat groups and marks password-protected groups with [locked].

/vcgroup create <player|@a|@s|@r|@p|@null> <type> "<group_name>" [persistent|not-persistent] ["password"]

Creates a new group. Using @null creates an empty group.

/vcgroup join <player|@a|@s|@r|@p> "<group_name>"

Moves players into an existing group.

/vcgroup kick <player|@a|@s|@r|@p>

Removes players from their current group.

/vcgroup remove "<group_name>"

Deletes a voice group and removes all members.

/vcgroup info "<group_name>"

Shows detailed information about a group.

---

🔐 /vcpermission — Voice permission management

/vcpermission give <player> <listen|speak|group>

Grants a voice permission and applies it live.

/vcpermission remove <player> <listen|speak|group>

Revokes a voice permission and updates the player instantly.

/vcpermission default <listen|speak|group> <true|false>

Sets global default values (defaults are true).

/vcpermission reset

Resets the entire permission system to factory defaults.

---

⚙️ Configuration

No setup required. Install VoiceServer alongside Simple Voice Chat and start using it immediately.

All permission data and persistent group settings are stored in config.yml. The plugin automatically migrates old keys and ensures a stable config structure.

---

⚠ Requirements

• Minecraft: 1.8.8 – 1.21.x
• Server: Folia, Paper, Spigot, Bukkit
• Dependency: Simple Voice Chat (Mod + API)
• The plugin must load after Simple Voice Chat.

---

💡 Example Use Cases

• Create dynamic voice groups for events, PvP, or minigames.
• Maintain permanent staff or admin voice channels.
• Use password-protected private groups without exposing passwords.
• Control who may listen, speak, or join groups on a per-player basis.

---

🧑‍💻 Developer Notes

• Developed by Jakomi1.
• Fully open source and community-friendly.
• Direct integration with VoicechatServerApi.
• Single PermissionAttachment per player (no duplication or leaks).
• Live permission updates without reloads.
• Folia-safe scheduling, selectors, and tab completion.
• Automatic creation of a minimal config.yml if missing.