# 📄 密码白名单
一个让用户在加入服务器时输入密码的插件。
## 快速链接
- [Paper 下载](https://modrinth.com/plugin/passwordwhitelist/versions?l=paper)
## 描述
这个插件为白名单增添了一种新的玩法！除了手动将玩家添加到你的白名单，你还可以设置一个服务器范围内的密码，所有连接的用户都必须在加入服务器时输入这个密码。这个插件利用了 Minecraft 1.21.6 更新引入的新对话系统，以及 Paper 在 1.21.7 中引入的新配置 API，使流程非常流畅。
## 特性
- 广泛的可定制性
- [MiniMessage 格式](https://docs.advntr.dev/minimessage/format.html)
- Minecraft 1.21.6 引入的新对话系统
- 异步配置阶段密码输入
## Folia 兼容性
Folia 兼容性是一个目标，截至写作时可能尚未实现，
因为到目前为止，尚未发布 Folia 1.21.7 的公共构建。
## Paper 兼容性
此插件应适用于所有 Paper 服务器，版本为 1.21.7 (build #17) 及更高版本。
## 权限
⚠️ 建议您安装 [LuckPerms](https://modrinth.com/plugin/luckperms) 以管理权限。
下表列出了所有权限、它们的默认值以及它们的描述：
| 权限 | 默认值 | 描述 |
|-----------------------------------------|---------|------------------------------------------------------------------------------|
| passwordwhitelist.exclude | false | 排除用户无需输入密码 |
| passwordwhitelist.command.use | op | 运行 /passwordwhitelist 命令所需的权限 |
| passwordwhitelist.command.help | true | 运行 '/passwordwhitelist help' 子命令所需的权限 |
| passwordwhitelist.command.reload | true | 运行 '/passwordwhitelist reload' 子命令所需的权限 |
| passwordwhitelist.command.enable | true | 运行 '/passwordwhitelist enable' 子命令所需的权限 |
| passwordwhitelist.command.disable | true | 运行 '/passwordwhitelist disable' 子命令所需的权限 |
| passwordwhitelist.command.attempts | true | 运行 '/passwordwhitelist attempts' 子命令所需的权限 |
| passwordwhitelist.command.password | true | 运行 '/passwordwhitelist password' 子命令所需的权限 |
| passwordwhitelist.command.password.set | op | 运行 '/passwordwhitelist password set' 子命令所需的权限 |
| passwordwhitelist.command.password.show | op | 运行 '/passwordwhitelist password show' 子命令所需的权限 |
如果您对某些子命令的 `true` 值感到困惑：它们之所以被设置为 `true` 的唯一原因是使快速权限设置更容易。所有玩家都需要 `passwordwhitelist.command.use` 权限
才能使用任何命令。子权限只是为了服务器所有者提供细粒度的控制。
### 关于排除权限的说明
由于在玩家服务器连接的配置阶段检查排除权限，因此无法
使用 Paper 的 API 检查玩家的权限。因此，此功能要求
安装 [LuckPerms](https://luckperms.net)
到服务器上。
## 命令
- 别名：`passwordwhitelist`、`/passw` 和 `/pw`。
| 命令 | 描述 |
|----------------------------------------------|------------------------------------------------|
| `/passwordwhitelist help` | 显示帮助消息 |
| `/passwordwhitelist reload []` | 重新加载插件数据文件 |
| `/passwordwhitelist enable` | 启用密码白名单 |
| `/passwordwhitelist disable` | 禁用密码白名单 |
| `/passwordwhitelist password set ` | 设置一个新的密码 |
| `/passwordwhitelist password show` | 显示当前的密码 |
| `/passwordwhitelist attempt reset ` | 重置玩家的失败密码尝试计数 |