Voice-Group-Manager

Voice Group Manager

An unofficial Paper & Purpur port of Simple Voice Chat Enhanced Groups — bringing server-side management for Simple Voice Chat groups to Servers: persistent groups, automatic group joining, instant nearby groups, and admin tools.

Requirements

• Server: Paper or Purpur running Minecraft 1.21.1 through 26.3 (Spigot and Folia are not supported)
• Dependency: The Bukkit version of Simple Voice Chat

Features

• Persistent Groups: Save groups across server restarts and edit their name, type, visibility, or password in place without recreating them or kicking current members.
• Personal & Global Auto-Join: Let players choose their own auto-join group, or set a server-wide default (with an option to force-override personal choices).
• Instant Nearby Groups: Group nearby voice-connected players in one command (/instantgroup) — ideal for events or impromptu conversations.
• Force Join: Move any voice-connected player into any running group from in-game or the console (/forcejoingroup).
• Join Summary: Greet joining players with a list of active, visible voice groups and one-click [Join] buttons.
• Forced Group Types: Optionally enforce NORMAL, OPEN, or ISOLATED on groups.
• Live Admin Overview: Inspect active groups via /voicegroupmanager info and /voicegroupmanager groups.

Commands

The group types match Simple Voice Chat's normal, open, and isolated modes. In config.yml, force_group_type can be set to OFF, NORMAL, OPEN, or ISOLATED; it applies to groups created through the SVC client GUI and does not override /persistentgroup add.

How Auto-Join Works

Auto-join automatically moves a player into a persistent group each time their Simple Voice Chat client connects after joining the server.

• Personal: /autojoingroup set <group> [password] sets your personal group (if password-protected, enter the password once when setting it). /autojoingroup remove clears it.
• Global: /autojoingroup global set <group> sets a server-wide default group (cannot have a password). /autojoingroup global remove clears it.
• Priority Order: When a player connects, the plugin picks the first running group from:
  1. Global group (if /autojoingroup global force true is enabled)
  2. Personal group
  3. Global group (fallback)

Groups that are not currently running are skipped. Players without the Simple Voice Chat mod are unaffected, and moved players are notified unless notify_moved_players is false.

Permissions & Configuration

Permission Nodes

• voicegroupmanager.instantgroup — Use /instantgroup
• voicegroupmanager.persistentgroup — Use /persistentgroup
• voicegroupmanager.autojoingroup — Use /autojoingroup for yourself
• voicegroupmanager.autojoingroup.global — Use /autojoingroup global
• voicegroupmanager.forcejoingroup — Use /forcejoingroup
• voicegroupmanager.reload — Use /voicegroupmanager reload
• voicegroupmanager.info — Use /voicegroupmanager info and groups
• voicegroupmanager.admin — Grants all permissions above, regardless of config.yml defaults

Configuration (config.yml & messages.yml)

• Permission Defaults: Configure default access for command nodes in config.yml as EVERYONE, OPS, or NOONE (permission plugins like LuckPerms can still override individual nodes).
• Custom Messages: All text and the chat prefix can be edited in messages.yml (deleted keys fall back to built-in defaults). Legacy & colour codes are used by default; set message_format: MINIMESSAGE in config.yml to use MiniMessage tags such as <green> or <gradient:red:blue> (& codes continue working in MiniMessage mode too).

Security note: Persistent-group passwords are stored in plain text inside persistent-groups.yml so the plugin can restore groups on startup and validate auto-join settings. Restrict access to the plugin data folder accordingly, and keep in mind that passwords typed into commands may appear in your server console and command logs.

License & Credits

• Ported to Paper by SilkyPanda with permission from the original author.
• Original Fabric mod: Simple Voice Chat Enhanced Groups by Max Henkel (henkelmax).