- 版权类型
- 原创
- 插件中文名称
- 白名单管理器
- 插件英文名称
- WhitelistManager
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Purpur
- 语言支持
- 中文(简体)
- 适配版本(Java)
- 26.x
- 1.21
- 1.20
[MD]
# WhitelistManager 白名单管理插件 · 功能介绍
一款专为 Bukkit 系核心(Paper / Spigot / Purpur 等)Minecraft 服务器设计的白名单管理插件,提供**网页后台**、**邮箱验证**、**问卷系统**与 **QQ 机器人**等一体化能力。
> 支持版本:1.20.1 及以上(低版本自动禁用)
> 运行环境:Java 17 / 21+
> 插件结构:`WhitelistManager`(免费版·必装)+ `WhitelistManager-Pro`(高级版扩展·选装)
---
## 一、免费版功能(WhitelistManager)
### 1. 网页管理后台
- 浏览器访问 `http://服务器IP:32123` 即可进入后台,默认账号 `admin` / `admin123`(建议首次登录后修改)。
- 全中文界面,无需任何命令操作,所有管理均可在网页上完成。
### 2. 白名单管理
- 在线查看、添加、删除玩家白名单。
- 支持为玩家记录 **QQ 号、邮箱、备注** 等扩展信息。
- 玩家条目与游戏内白名单实时同步。
### 3. 白名单申请
- 玩家可通过网页自助申请加入白名单。
- 开启邮箱验证后,申请需填写邮箱并通过验证邮件确认,有效防误填。
- 管理员可在后台审批/驳回申请。
### 4. 移除申请
- 玩家可在线提交移除申请,管理员后台统一处理。
### 5. 公告发布
- 管理员可在后台编辑并发布服务器公告,玩家通过指定页面或入口查看。
### 6. 账号与权限
- 后台账号体系:默认管理员账号,支持修改密码。
- 可创建普通用户账号(支持填写 **QQ 号(可选)** 与 **备注(可选)**),便于多人分工管理。
- 账号管理、创建、编辑、删除全程可视化。
### 7. 邮箱(SMTP)通知
- 支持配置 SMTP 服务器(如 QQ 邮箱),用于发送验证邮件、审批结果通知等。
- 支持 SSL / STARTTLS 加密连接。
### 8. 系统设置
- 网页后台在线修改监听端口、默认管理员、SMTP、邮件模板等配置,实时持久化。
### 9. 云更新
- 支持从 GitHub Releases 自动检测并下载新版本。
- 更新包带 SHA-256 校验,防止篡改。
- Linux / macOS 自动应用更新;Windows 下载后需手动替换 jar 重启。
---
## 二、高级版功能(WhitelistManager-Pro)
> 高级版为独立扩展插件,需与免费版一起放入 `plugins/`,并通过**卡密激活**后启用。
### 1. 内置问卷系统
- 后台**可视化编辑**问卷:可自由添加文本、多行文本、数字、手机号、邮箱、单选、多选等组件。
- 每个组件支持:
- 修改标题文本、提示语
- 设置是否**必填 / 必选**
- 设置选项内容(单选 / 多选)
- 组件可**绑定白名单属性**:玩家提交问卷后,可自动写回玩家记录的对应字段(如 QQ、邮箱等)。
- 问卷页面长度根据内容自适应。
- 每份问卷**独立设置访问端口**,问卷页面向玩家单独开放。
- 提交结果自动保存,支持查看答卷记录。
- 可开启邮件通知,问卷提交后自动发送通知给指定邮箱。
- 支持一键**删除问卷**(连同其全部提交结果一并清除)。
### 2. QQ 机器人
- 群内白名单查询、在线申请等交互。
- 扫码登录接入 NapCat / WebSocket,无需额外安装客户端。
### 3. 卡密激活
- 高级版功能需使用卡密激活,一卡密绑定一台服务器。
- 通过爱发电购买卡密后,在后台「高级版」页面粘贴卡密即可激活。
---
## 三、安装与使用
### 安装
1. 将 `WhitelistManager-2.0.2.jar` 放入服务器 `plugins/` 目录(免费版必装)。
2. 如需要高级功能,同时放入 `WhitelistManager-Pro-1.0.1.jar`(Pro 依赖免费版)。
3. 重启服务器(或使用 `/reload confirm` 加载)。
4. 浏览器访问 `http://服务器IP:32123` 进入后台。
### 高级版激活
1. 在后台左侧「高级版」页查看激活状态。
2. 通过爱发电购买卡密:https://ifdian.net/a/ytdxy
3. 将卡密粘贴到激活输入框,点击激活即可。
### 云更新
- 后台「云更新」页可查看版本、检测更新。
- 配置 `config.yml` 中的 `update.enable` 开启自动更新(默认开启)。
---
## 四、版本信息
| 组件 | 版本 | 说明 |
| --- | --- | --- |
| WhitelistManager | 2.0.2 | 免费版,核心功能 |
| WhitelistManager-Pro | 1.0.1 | 高级版扩展,含问卷 / QQ机器人 / 卡密 |
---
## 五、联系方式
- 作者:一条大咸鱼
- QQ:1706136209
- 爱发电:https://ifdian.net/a/ytdxy
[/MD]