Voice Group Manager

插件

· 作者 SilkyPanda

Paper/Purpur 移植版的 Simple Voice Chat Enhanced Groups:即时且持久的群组、自动加入、强制群组类型等。

0 本站下载 0 关注 更新于 2 天前

需要前置:Simple Voice Chat

最新 1.4.0 · 26.3 · Folia / Paper

一键开服(送7天)

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 清除该设置。
  • 优先级顺序: 当玩家连接时,插件按以下顺序选择第一个正在运行的群组:
    1. 全局群组 (如果启用了 /autojoingroup global force true)
    2. 个人群组
    3. 全局群组 (回退)

未处于运行状态的群组将被跳过。没有安装 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 中,以便插件在启动时恢复群组并验证自动加入设置。请相应地限制对插件数据文件夹的访问权限,并注意通过命令输入的密码可能会出现在服务器控制台和命令日志中。

许可与致谢

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源