🎙️ VoiceServer – Powerful Group Management for Simple Voice Chat

VoiceServer is a lightweight yet advanced Paper plugin that makes managing Simple Voice Chat groups effortless. Use intuitive commands with full tab completion to organize, secure, and monitor voice chat groups in real time — ideal for servers with events, teams, or dynamic player structures.

---

🚀 Key Features

• 📋 List all voice chat groups
  Shows all active Simple Voice Chat groups — including password-protected ones.
  Now displays [locked] instead of showing the password in listings!
• 🆕 Create new groups (persistent option & optional password)
  Instantly create groups with persistent or not-persistent settings, and assign players — optionally password-protected for persistent groups.
• 🧑‍🤝‍🧑 Join players to existing groups
  Use the join command to move players (with selectors: @a, @s, @r, @p) into any group — replacing the old add functionality.
• ❌ Remove players from groups
  Remove players from their groups; kick supports all selectors (@a, @s, @r, @p) and works group-agnostically.
• 🗑️ Safely delete groups
  Remove unused or outdated groups — including password protection. Non-persistent groups are auto-deleted when empty; persistent groups remain until manually removed.
• 🛡️ Access control via permissions
  Unified permission voicechat.group.manage for all group management commands.
• ⚡ Full tab completion support
  Commands and arguments autocomplete with Tab for faster workflows.
  Now includes new player selectors @r (random) and @p (nearest), and shows group names in quotes for clarity.
• 🔐 Password awareness and security
  Lists indicate groups with password protection ([locked]), password is never revealed.
• 📌 Persistent groups
  Create groups that remain even after all members leave — ideal for staff, admin, or permanent team channels.
• 🐞 Debug logging & safe error handling
  Clear messages and graceful error handling for stability.

---

🧭 Commands

/vcgroup list 

→ Lists all current voice chat groups, showing if a group is password protected as [locked].

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

→ Creates a new group and adds the specified players. Use persistent to make the group stay even if everyone leaves. Password protection is optional (only for persistent groups).

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

→ Joins specified players to an existing group.

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

→ Removes players from their current group (no group argument needed). Supports selectors for batch actions.

/vcgroup remove "<group_name>" 

→ Deletes a voice group (persistent or temporary) and removes its password protection, if any, kicking members automatically.

---

⚙️ Configuration

No setup required. Just install alongside Simple Voice Chat and get started.

---

⚠ Requirements

• Minecraft: 1.20 - 1.21.8
• Server type: Paper or compatible forks (e.g., Purpur, Pufferfish)
• Dependencies: Simple Voice Chat Mod + API
• The plugin must load after Simple Voice Chat to register correctly.

---

💡 Example Use Cases

• Dynamically create voice chat groups for PvP, minigames, or events and assign players using selectors — random, nearest, all, or sender.
• Create password-protected or private groups for staff or factions ([locked] shown, password hidden), with persistence if needed.
• Easily move, join, or remove players from their groups, with instant auto-removal if a non-persistent group becomes empty.
• Make permanent groups like "Admin" that stay available even after all members have left.

---

🧑‍💻 Developer Notes

• Developed by Jakomi1 with focus on performance, usability, and API-first design.
• Direct integration with VoicechatServerApi and Kyori Adventure for messaging.
• Actively maintained and easily extensible.
• All permission nodes are managed and injected at runtime as needed.