🎙️ VoiceServer – Powerful Group Management for Simple Voice Chat

VoiceServer is a lightweight yet advanced plugin for managing Simple Voice Chat groups with intuitive commands, full tab completion, and real-time control for events, teams, and dynamic player structures.

Fully compatible with Folia, Paper, Spigot, and Bukkit, supporting Minecraft versions from 1.8.8 up to 1.21.x and compatibility support for 26.1.X.

Open Source:

https://github.com/Jakomi1/VoiceServer

---

🚀 Key Features

• List all voice chat groups – Shows all active groups; password-protected groups are displayed as [locked] instead of revealing passwords.
• Create groups – Supports persistent and non-persistent groups, with optional password protection for persistent groups.
• Join players to groups – join supports selectors like @a, @s, @r, and @p.
• Remove players from groups – kick removes players from their current group without needing a group argument.
• Safely delete groups – Non-persistent groups are removed automatically when empty; persistent groups stay until deleted manually.
• Default group assignment – Players can be placed automatically into a predefined group on join with /vcgroup default <groupname> [persistent].
• Command aliases – Short aliases are available for faster workflow:
  • /vcpermission → /voicepermission
  • /vcserver → /voiceserver
  • /vcgroup → /voicegroup
• Access control – Group management commands are protected by voicechat.group.manage.
• Full tab completion – Supports commands, players, selectors, group names, and quoted arguments with Folia-safe tab completion.
• Persistent groups – Ideal for staff, admin, or permanent team channels.
• Persistence across restarts (optional) – The config option persistent-groups-should-survive-restart lets persistent groups survive restarts or reloads (default: false).
• Create empty groups – Use @null with /vcgroup create to create a group without players.
• Group info – /vcgroup info shows type, persistence, lock status, and members.
• Voice permission management – Per-player permissions via /vcpermission for listen, speak, and group.
• Debug logging and stable error handling – Improved debugging and robust handling for safer operation.
• Folia-supported scheduler – Built with Folia-safe scheduling support.

---

🧭 Commands

Voice groups

/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.

/vcgroup default <groupname> [persistent]

Sets the default group players are automatically placed into when joining.

Voice permissions

/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 keeps the config structure stable.

---

⚠ 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.