- 版权类型
- 转载
- 插件中文名称
- 语音服务器
- 插件英文名称
- VoiceServer
- 支持的核心(服务端)
- Spigot
- Paper
- Folia
- Purpur
- Leaves
- 适配版本(Java)
- 26.x
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
- 1.15
- 1.14
- 1.13
- 1.12
- 1.11
- 1.10
- 1.9
- 1.8
[MD]
# 🎙️ VoiceServer – 简易语音聊天强力群组管理工具
**VoiceServer** 是一款轻量且功能进阶的插件,可用于管理**简易语音聊天(Simple Voice Chat)**群组,支持直观的指令操作、完整的Tab补全,以及针对活动、队伍、动态玩家结构的实时管控,完全兼容**Folia**、**Paper**、**Spigot**和**Bukkit**服务端,支持从**1.8.8**到**26.2**版本的《我的世界》,
**开源地址:** [https://github.com/Jakomi1/VoiceServer](https://github.com/Jakomi1/VoiceServer)
* * *
## 🚀 主要特性
* **查看所有语音群组** – 可显示所有处于激活状态的群组,
* **创建群组** – 支持持久化与非持久化群组,持久化群组可额外设置密码保护,
* **将玩家加入群组** – `join`指令支持`@a`、`@s`、`@r`、`@p`等选择器,
* **将玩家移出群组** – `kick`指令无需指定群组参数,即可将玩家移出当前所在群组,
* **安全删除群组** – 非持久化群组在无成员时会自动移除,持久化群组需手动删除才会消失,
* **默认群组分配** – 玩家加入服务器时可自动被分配到预设的默认群组,使用`/vcgroup default <groupname> [persistent]`指令即可设置,
* **指令别名** – 提供短别名以提升操作效率:
* `/vcpermission` → `/voicepermission`
* `/vcserver` → `/voiceserver`
* `/vcgroup` → `/voicegroup`
* **权限管控** – 群组管理指令受`voicechat.group.manage`权限保护,
* **完整的Tab补全** – 支持指令、玩家名、选择器、群组名以及带引号的参数,补全逻辑适配Folia服务端,不会出现兼容问题,
* **持久化群组** – 非常适合用作工作人员、管理员或固定队伍的语音频道,
* **重启后持久化(可选)** – 配置项`persistent-groups-should-survive-restart`可让持久化群组在服务端重启或重载后依然保留,默认值为`false`,
* **创建空群组** – 使用`/vcgroup create`指令时搭配`@null`参数,即可创建不含任何玩家的空群组,
* **群组信息查询** – 使用`/vcgroup info`指令可查看群组的类型、持久化状态、锁定状态以及成员列表,
* **语音权限管理** – 通过`/vcpermission`指令可为单个玩家设置`listen`(收听)、`speak`(发言)、`group`(群组)三类权限,
* **调试日志与稳定的错误处理** – 优化了调试功能,错误处理机制更健壮,保障插件稳定运行,
* **适配Folia的调度器** – 内置适配Folia的调度支持,
* * *
## 🧭 指令说明
### 语音群组
```
/vcgroup list
```
查看所有语音群组,密码保护的群组会标注`[locked]`标记,
```
/vcgroup create <player|@a|@s|@r|@p|@null> <type> "<group_name>" [persistent|not-persistent] ["password"]
```
创建新群组,使用`@null`参数可创建空群组,
```
/vcgroup join <player|@a|@s|@r|@p> "<group_name>"
```
将玩家移动到已有的群组中,
```
/vcgroup kick <player|@a|@s|@r|@p>
```
将玩家移出当前所在的群组,
```
/vcgroup remove "<group_name>"
```
删除指定语音群组,同时移除所有群组成员,
```
/vcgroup info "<group_name>"
```
查看群组的详细信息,
```
/vcgroup default <groupname> [persistent]
```
设置玩家加入服务器时自动进入的默认群组,
### 语音权限
```
/vcpermission give <player> <listen|speak|group>
```
授予玩家对应的语音权限,设置后立即生效,
```
/vcpermission remove <player> <listen|speak|group>
```
撤销玩家的语音权限,设置后立即更新,
```
/vcpermission default <listen|speak|group> <true|false>
```
设置全局默认权限值,默认均为`true`,
```
/vcpermission reset
```
将整个权限系统重置为出厂默认设置,
* * *
## ⚙️ 配置说明
无需额外配置,将**VoiceServer**与**简易语音聊天(Simple Voice Chat)**一同安装即可直接使用,所有权限数据与持久化群组设置均存储在`config.yml`文件中,插件会自动迁移旧版配置键,保持配置结构稳定,
* * *
## ⚠️ 运行要求
* **《我的世界》版本:** 1.8.8 – 26.2
* **服务端核心:** Folia、Paper、Spigot、Bukkit
* **依赖插件:** 简易语音聊天(Simple Voice Chat)(Mod + API)
* * *
## 💡 适用场景
* 为活动、PvP、小游戏创建动态语音群组,
* 维护固定工作人员或管理员的专属语音频道,
* 使用密码保护的私密群组,无需泄露群组密码,
* 按玩家单独管控其收听、发言、加入群组的权限,
* * *
## 🧑💻 开发者说明
* 由**Jakomi1**开发,
* 完全开源,欢迎社区贡献,
* 适配Folia的调度、选择器与Tab补全功能,
[/MD]