# pv-addon-groups
服务器端 [Plasmo Voice](https://modrinth.com/mod/plasmo-voice) 插件。
创建群组语音聊天频道。 让远距离的玩家也能畅聊。
群组通过聊天命令进行管理。 GUI 客户端插件正在开发中™。
群组可以设置密码保护，或者仅允许具有特定权限的玩家加入。
## 安装
你可以将此插件安装为（Paper, Fabric, Forge）或（Bungee, Velocity）模组/插件
如果你将其安装为 Bungee 或 Velocity 插件，那么群组将适用于所有服务器上的玩家。
玩家可以在不同的服务器上聊天。
## 基本用法
### 创建群组和邀请玩家
1. 打开 Plasmo Voice 菜单 `V`（默认），进入 `激活` 选项卡，并配置 `群组` 激活。
2. 使用命令创建群组 `/groups create [...flags]`
3. 邀请玩家加入群组 `/groups invite `
3. 使用激活在群组中聊天。
### 浏览群组
你可以使用命令浏览公共群组：`/groups` 或 `/groups browse`
## Flags
你可以使用 flags 在创建群组时更改设置。
例如: `/groups create name: The Boys password: qwerty1245 persistent: true permissions: group.theboys`
所有 flags 都是可选的，且顺序不重要。
`name:` 和 `password:` 比较明显。
`persistent:` 使得群组不会在空闲或服务器重启后自动删除。
`permissions:` 仅允许具有特定权限的玩家加入。
你可以设置多个权限：`permissions: group.admin, group.moderator`
### Flags 权限
| Flag | Permission | Default |
|---------------|------------------------------------|---------|
| `name` | `pv.addon.groups.flag.name` | True |
| `password` | `pv.addon.groups.flag.password` | True |
| `persistent` | `pv.addon.groups.flag.persistent` | OP |
| `permissions` | `pv.addon.groups.flag.permissions` | OP |
## 命令
`/groups` 或 `/groups browse [page]` — 浏览群组。
`/groups create [...flags]` — 创建群组。
`/groups invite ` — 邀请玩家加入群组。
`/groups join [password]` — 加入群组。 不建议手动使用。 从浏览或邀请中使用。
`/groups info` — 显示当前群组的信息。
`/groups leave` — 离开当前群组。
`/groups set ` — 设置当前群组的 flag 值。
`/groups unset ` — 将 flag 设置为默认值。
`/groups delete` — 删除当前群组。
`/groups transfer ` — 将群组所有权转移给其他玩家。
`/groups kick ` — 将玩家从群组中踢出。
`/groups ban ` — 封禁玩家进入群组。
`/groups unban ` — 解封玩家进入群组。
## 权限
| Permission | Description | Default |
|----------------------------------|---------------------------------------------------------------------|---------|
| `pv.activation.groups` | 使用群组激活 | True |
| `pv.addon.groups.browse` | 使用 `/groups browse` | True |
| `pv.addon.groups.browse.all` | 群组对即使玩家没有加入权限也能可见 | OP |
| `pv.addon.groups.create` | 使用 `/groups create` | True |
| `pv.addon.groups.invite.member` | 使用 `/groups invite` 如果是成员 | True |
| `pv.addon.groups.invite.owner` | 使用 `/groups invite` 如果是所有者 | True |
| `pv.addon.groups.join` | 使用 `/groups join` | True |
| `pv.addon.groups.join.all` | 使用 `/groups join` 并绕过密码和权限检查 | OP |
| `pv.addon.groups.info.member` | 使用 `/groups info` 如果是成员 | True |
| `pv.addon.groups.info.owner` | 使用 `/groups info` 如果是所有者 | True |
| `pv.addon.groups.leave` | 使用 `/groups leave` | True |
| `pv.addon.groups.set.owner` | 使用 `/groups set` 如果是所有者 | True |
| `pv.addon.groups.set.all` | 使用 `/groups set` 在任何群组中 | OP |
| `pv.addon.groups.unset.owner` | 使用 `/groups unset` 如果是所有者 | True |
| `pv.addon.groups.unset.all` | 使用 `/groups unset` 在任何群组中 | OP |
| `pv.addon.groups.delete.owner` | 使用 `/groups delete` 如果是所有者 | True |
| `pv.addon.groups.delete.all` | 使用 `/groups delete` 在任何群组中 | OP |
| `pv.addon.groups.transfer.owner` | 使用 `/groups transfer` 如果是所有者 | True |
| `pv.addon.groups.transfer.all` | 使用 `/groups transfer` 在任何群组中 | OP |
| `pv.addon.groups.kick.owner` | 使用 `/groups kick` 如果是所有者 | True |
| `pv.addon.groups.kick.all` | 使用 `/groups kick` 在任何群组中 | OP |
| `pv.addon.groups.ban.owner` | 使用 `/groups ban/unban` 如果是所有者 | True |
| `pv.addon.groups.ban.all` | 使用 `/groups ban/unban` 在任何群组中 | OP |