🎙️ VoiceServer – Powerful Group Management for Simple Voice Chat

VoiceServer is a lightweight yet advanced Paper 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, making it perfect for servers hosting events, teams, or dynamic player structures.

---

🚀 Key Features

• 📋 List all voice chat groups
  View all active Simple Voice Chat groups, including those with password protection. Groups with passwords now show [locked] instead of revealing the password in listings!
• 🆕 Create new groups with optional persistence or password protection
  You can instantly create groups that are either persistent or non-persistent and assign players to them, with the option to secure persistent groups with a password.
• 🧑‍🤝‍🧑 Join players to existing groups
  The join command allows you to move players, using selectors like @a, @s, @r, or @p, into any group. The internal playerGroupMap ensures the group state stays consistent.
• ❌ Remove players from groups
  You can remove players from their current group with the kick command, which supports selectors for batch actions.
• 🗑️ Safely delete groups
  Unused or outdated groups can be removed safely. Non-persistent groups are automatically deleted when empty, while persistent groups remain until manually removed.
• 🛡️ Access control via permissions
  All group management commands are secured under the unified permission voicechat.group.manage.
• ⚡ Full tab completion support
  Commands and their arguments autocomplete with Tab for faster workflows. Online players and selectors compatible with Folia are suggested automatically, and group names are enclosed in quotes for clarity.
• 📌 Persistent groups
  Groups can be created to remain available even after all members leave, making them ideal for staff, admin, or permanent team channels.
• 🐞 Debug logging and safe error handling
  Clear messages and graceful error handling ensure stability at all times.
• ℹ️ New info command
  Displays details such as the group type, persistence, lock status, and the current members.
• ⚙️ Automatic handling of empty non-persistent groups
  Groups are automatically removed when the last member leaves or is kicked.

---

🧭 Commands

/vcgroup list 

This command lists all current voice chat groups and indicates whether a group is password-protected using [locked].

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

Use this command to create a new group and add the specified players. If persistent is selected, the group will remain even if everyone leaves. Password protection is optional for persistent groups.

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

This command joins the specified players to an existing group, with playerGroupMap ensuring the group state stays consistent.

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

This command removes players from their current group, and selectors can be used for batch actions. The group argument is no longer required.

/vcgroup remove "<group_name>" 

This command deletes a voice group, whether persistent or temporary, removes its password protection, and kicks members automatically.

/vcgroup info "<group_name>" 

This command shows the group type, persistence, lock status, and current members.

---

⚙️ Configuration

No setup is required. Simply install VoiceServer alongside Simple Voice Chat and you are ready to start.

---

⚠ Requirements

• Minecraft: 1.20 - 1.21.8
• Server type: Paper or compatible forks such as Purpur or Pufferfish
• Dependencies: Simple Voice Chat Mod and API
• The plugin must load after Simple Voice Chat to register correctly.

---

💡 Example Use Cases

• You can dynamically create voice chat groups for PvP, minigames, or events, assigning players using selectors like random, nearest, all, or sender.
• Password-protected or private groups can be created for staff or factions, with [locked] displayed while the password remains hidden, and persistence applied if needed.
• Players can be easily moved, joined, or removed from groups, with instant auto-removal when a non-persistent group becomes empty.
• Permanent groups such as "Admin" can be created and remain available even after all members have left.

---

🧑‍💻 Developer Notes

• Developed by Jakomi1, focusing on performance, usability, and API-first design.
• Integrates directly with VoicechatServerApi and Kyori Adventure for messaging.
• The plugin is actively maintained and designed for easy extensibility.
• All permission nodes are dynamically managed and injected at runtime as needed.
• Fully compatible with FoliaMC.