Voice Group Manager
一个非官方的 Paper、Purpur 和 Folia 移植版 Simple Voice Chat Enhanced Groups —— 为服务器上的 Simple Voice Chat 群组带来服务端管理功能:持久化群组、自动加入群组、即时附近群组以及管理员工具。
要求
- 服务器: 运行 Minecraft 1.21.1 至 26.3 版本的 Paper、Purpur 或 Folia (不支持 Spigot)
- 依赖项: Simple Voice Chat 的 Bukkit 版本
特性
- 持久化群组: 在服务器重启后保存群组,并就地编辑其名称、类型、可见性或密码,而无需重新创建或踢出当前成员。
- 个人与全局自动加入: 允许玩家选择自己的自动加入群组,或设置全服默认群组(提供选项以强制覆盖个人选择)。
- 即时附近群组: 使用一条命令 (
/instantgroup) 将语音连接在一起的附近玩家编入一个群组 —— 非常适合活动或临时对话。
- 强制加入: 从游戏内或控制台将任何语音连接的玩家移入任意正在运行的群组 (
/forcejoingroup)。
- 加入摘要: 向加入的玩家展示活跃且可见的语音群组列表,并提供一键
[Join] 按钮。
- 强制群组类型: 可选地强制对群组应用
NORMAL、OPEN 或 ISOLATED 类型。
- 实时管理员概览: 通过
/voicegroupmanager info 和 /voicegroupmanager groups 检查活跃群组。
命令
| 命令 |
功能说明 |
/instantgroup [range] |
将尚未处于任何群组中的附近语音连接玩家添加到你当前的群组中;如果你不在群组中,则创建一个开放的临时群组。半径(以方块为单位)默认为 128(受 max_instant_group_range 限制)。隐身玩家将被跳过。默认仅限 OP 使用。 |
/persistentgroup list |
列出已保存的持久化群组。 |
/persistentgroup add <name> [<normal|open|isolated> [<true|false> [password]]] |
创建一个持久化群组。除非设置了密码,否则类型 (type) 和隐藏状态 (hidden) 是可选的:类型默认为 normal,隐藏状态默认为 false。如果设置了密码,则必须先指定类型和隐藏状态,密码可以包含空格(例如 /persistentgroup add Lobby、/persistentgroup add "Staff Chat" open 或 /persistentgroup add Staff isolated true hunter2)。名称必须唯一。 |
/persistentgroup edit <name|id> <name|type|hidden|password> <value> |
编辑已保存群组的单个属性,而不会丢失在线成员。使用 none 作为值来移除密码。 |
/persistentgroup remove <name|id> |
移除已保存的群组(如果 Simple Voice Chat 允许),并清除指向该群组的任何自动加入设置。 |
/autojoingroup set <name> [password] |
设置你的个人自动加入群组。 |
/autojoingroup remove |
清除你的个人自动加入设置。 |
/autojoingroup global set <name> |
设置全服默认的自动加入群组。目标群组不能有密码。 |
/autojoingroup global remove |
清除全服默认的自动加入群组。 |
/autojoingroup global force <true|false> |
选择是否让全服默认的自动加入群组覆盖个人设置。 |
/forcejoingroup <player> <group name or ID> |
通过已保存的名称、群组 ID 或活跃群组名称,将一名在线且语音连接的玩家移入正在运行的语音群组。支持从控制台执行,并跳过密码检查。 |
/voicegroupmanager reload (别名 /vgm reload) |
重载 config.yml 和 messages.yml。 |
/voicegroupmanager info |
显示插件版本、语音聊天状态、已保存/正在运行的持久化群组、全服自动加入群组以及强制群组类型。 |
/voicegroupmanager groups |
列出当前在线玩家正在使用的全部语音群组,包括隐藏群组。点击某一行可复制其群组 ID。 |
群组类型对应 Simple Voice Chat 的 normal、open 和 isolated 模式。在 config.yml 中,force_group_type 可以设置为 OFF、NORMAL、OPEN 或 ISOLATED;它适用于通过 SVC 客户端 GUI 创建的群组,并且不会覆盖 /persistentgroup add。
自动加入工作原理
每次玩家的 Simple Voice Chat 客户端在加入服务器后连接时,自动加入功能会自动将其移入持久化群组。
- 个人:
/autojoingroup set <group> [password] 设置你的个人群组(如果受密码保护,请在设置时输入一次密码)。/autojoingroup remove 清除该设置。
- 全局:
/autojoingroup global set <group> 设置全服默认群组(不能包含密码)。/autojoingroup global remove 清除该设置。
- 优先级顺序: 当玩家连接时,插件按以下顺序选择第一个正在运行的群组:
- 全局群组 (如果启用了
/autojoingroup global force true)
- 个人群组
- 全局群组 (回退)
未处于运行状态的群组将被跳过。没有安装 Simple Voice Chat 模组不受影响,除非 notify_moved_players 为 false,否则被移动的玩家会收到通知。
权限与配置
权限节点
voicegroupmanager.instantgroup — 使用 /instantgroup
voicegroupmanager.persistentgroup — 使用 /persistentgroup
voicegroupmanager.autojoingroup — 为自己使用 /autojoingroup
voicegroupmanager.autojoingroup.global — 使用 /autojoingroup global
voicegroupmanager.forcejoingroup — 使用 /forcejoingroup
voicegroupmanager.reload — 使用 /voicegroupmanager reload
voicegroupmanager.info — 使用 /voicegroupmanager info 和 groups
voicegroupmanager.admin — 授予上述所有权限,无论 config.yml 的默认值如何
配置 (config.yml & messages.yml)
- 权限默认值: 在
config.yml 中为命令节点配置默认的访问权限,可选值为 EVERYONE、OPS 或 NOONE(LuckPerms 等权限插件仍可单独覆盖各个节点)。
- 自定义消息: 所有文本及聊天前缀均可在
messages.yml 中进行编辑(缺失的键将回退至内置默认值)。默认情况下使用传统的 & 颜色代码;在 config.yml 中设置 message_format: MINIMESSAGE 即可使用 MiniMessage 标签,例如 <green> 或 <gradient:red:blue>(在 MiniMessage 模式下,& 代码依然有效)。
安全提示: 持久化组密码以明文形式存储在 persistent-groups.yml 中,以便插件在启动时恢复群组并验证自动加入设置。请相应地限制对插件数据文件夹的访问权限,并注意通过命令输入的密码可能会出现在服务器控制台和命令日志中。
许可与致谢
Voice Group Manager
An unofficial Paper, Purpur & Folia 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, Purpur or Folia running Minecraft 1.21.1 through 26.3 (Spigot is 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
| Command |
What it does |
/instantgroup [range] |
Add nearby voice-connected players who are not already in a group to your current group, or create an open temporary group if you are not in one. Radius in blocks defaults to 128 (capped by max_instant_group_range). Vanished players are skipped. Ops only by default. |
/persistentgroup list |
List saved persistent groups. |
/persistentgroup add <name> [<normal|open|isolated> [<true|false> [password]]] |
Create a persistent group. Type and hidden are optional unless you set a password: type defaults to normal and hidden to false. A password needs both before it and may contain spaces (e.g. /persistentgroup add Lobby, /persistentgroup add "Staff Chat" open, or /persistentgroup add Staff isolated true hunter2). Names must be unique. |
/persistentgroup edit <name|id> <name|type|hidden|password> <value> |
Edit one property of a saved group without losing online members. Use none as the value to remove a password. |
/persistentgroup remove <name|id> |
Remove a saved group (if Simple Voice Chat allows it) and clear any auto-join settings pointing to it. |
/autojoingroup set <name> [password] |
Set your personal auto-join group. |
/autojoingroup remove |
Clear your personal auto-join setting. |
/autojoingroup global set <name> |
Set the server-wide auto-join group. The target group must not have a password. |
/autojoingroup global remove |
Clear the server-wide auto-join group. |
/autojoingroup global force <true|false> |
Choose whether the server-wide auto-join group overrides personal settings. |
/forcejoingroup <player> <group name or ID> |
Move an online, voice-connected player into a running voice group by saved name, group ID, or active group name. Works from the console and skips password checks. |
/voicegroupmanager reload (alias /vgm reload) |
Reload config.yml and messages.yml. |
/voicegroupmanager info |
Display plugin version, voice chat status, saved/running persistent groups, global auto-join group, and forced group type. |
/voicegroupmanager groups |
List all voice groups currently in use by online players, including hidden groups. Click a line to copy its group ID. |
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:
- Global group (if
/autojoingroup global force true is enabled)
- Personal group
- 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
评论 0
登录后参与评分
还没有评论,来抢沙发吧