PendingWhitelist
在服务器开启白名单的情况下,追踪那些尝试加入服务器的玩家。
通常情况下,未被列入白名单的玩家会被拒绝,事情到此为止。PendingWhitelist 会保存这些尝试记录,以便工作人员可以检查是谁尝试加入,并在稍后进行处理。
功能
- 追踪被拒绝的加入尝试
- 存储玩家名称、UUID、尝试次数、首次尝试时间和最后尝试时间
- 用于管理待处理和白名单玩家的内置 GUI
- 向工作人员发送加入通知
- 通知中包含可点击的操作按钮
- 支持 Java 版和通过 Floodgate 支持的基岩版玩家
- 使用
/wlb命令专门管理基岩版白名单 - 可选的 SkinsRestorer 支持
- 玩家皮肤缓存
- 自动清理过期的待处理请求
- 本地持久化存储
/wl version检查更新
工作原理
- 玩家在服务器开启白名单时尝试加入。
- 加入请求按正常流程被拒绝。
- PendingWhitelist 记录该次尝试。
- 工作人员可以通过
/wl或/wl pl查看待处理玩家列表。 - 随后可以通过 GUI 界面或执行
/wl add <player>将该玩家添加到白名单中。 - 当安装了 Floodgate 时,也可以使用
/wlb add <player>来管理基岩版玩家。
GUI 界面
添加玩家
“添加玩家” GUI 显示以下顺序:
待处理玩家 → 在线玩家 → 曾经加入过的玩家
在待处理和在线部分中,基岩版玩家显示在 Java 版玩家之前。
左键点击玩家将其添加到白名单。
按住 Shift 键点击以添加当前页面上的所有玩家。

白名单玩家
白名单 GUI 显示当前在服务器白名单中的玩家。
左键点击移除一名玩家。
按住 Shift 键点击以移除当前页面上的所有玩家。

加入通知
拥有以下权限的工作人员:
pendingwhitelist.admin
可以在未列入白名单的玩家被拒绝接收时收到通知。
该通知包含用于处理请求的可点击操作按钮。
此外,还设有可配置的通知冷却时间,以防止重复尝试骚扰工作人员。

命令
| 命令 | 描述 |
|---|---|
/wl |
打开管理员仪表盘 |
/wl add |
打开“添加玩家”GUI |
/wl add <player...> |
将玩家添加到白名单 |
/wl list [page] |
列出白名单玩家 |
/wl remove |
打开“白名单玩家”GUI |
/wl remove <player...> |
从白名单中移除玩家 |
/wl pl [page] |
列出待处理玩家 |
/wl rpl |
打开“添加玩家”GUI(用于移除待处理状态) |
/wl rpl <player...> |
从待处理存储中移除玩家 |
/wlb add <player...> |
将基岩版玩家添加到白名单 |
/wl on |
启用服务器白名单 |
/wl off |
禁用服务器白名单 |
/wl reload |
重新加载插件配置 |
/wl version |
检查是否有更新的稳定版本 |
当安装了 Floodgate 时,可用 /wlb 命令。
所有管理命令都需要以下权限:
pendingwhitelist.admin
配置
插件目前包含以下设置项:
- 调试日志
- 聊天分页大小
- 加入尝试通知
- 通知冷却时间
- 自动清理旧的待处理请求
完整的配置详情请参阅 配置指南。
更改配置后,请使用:
/wl reload
存储
待处理请求存储在本地:
plugins/PendingWhitelist/pending.json
标准的 Minecraft 白名单仍由 Paper 管理在:
whitelist.json
无需单独的数据库。
依赖要求
- Paper 或 Purpur
- Minecraft 1.20+
- Java 17+
可选依赖
- Floodgate 用于支持基岩版
- SkinsRestorer 用于离线模式下的皮肤查询
安装
- 停止服务器。
- 将 PendingWhitelist JAR 文件放入
plugins文件夹。 - 启动服务器。
- 如有需要,编辑
plugins/PendingWhitelist/config.yml。 - 运行
/wl。
这就是所需的全部步骤。
bStats
PendingWhitelist 使用 bStats 进行匿名插件统计。
bStats 可以通过其全局配置进行禁用。
支持
如需报告错误或提出功能建议,请在 GitHub 上创建 Issue。
源代码可在 GitHub 仓库 获取。
PendingWhitelist
这是对标准白名单系统的一个小补充,用于追踪那些试图进入服务器的玩家。
PendingWhitelist
Keep track of players who try to join while your server whitelist is enabled.
Normally, a non-whitelisted player gets rejected and that's it. PendingWhitelist saves the attempt so staff can check who tried to join and deal with it later.
Features
- Keeps track of rejected join attempts
- Stores player name, UUID, attempt count, first attempt and last attempt
- In-game GUI for managing pending and whitelisted players
- Join notifications for staff
- Clickable notification actions
- Java and Bedrock player support with Floodgate
- Dedicated Bedrock whitelist management with
/wlb - Optional SkinsRestorer support
- Player skin caching
- Automatic cleanup of old pending requests
- Persistent local storage
/wl versionupdate checking
How it works
- A player tries to join while the whitelist is enabled.
- The join is rejected normally.
- PendingWhitelist records the attempt.
- Staff can check pending players with
/wlor/wl pl. - The player can then be added to the whitelist from the GUI or with
/wl add <player>. - Bedrock players can also be managed with
/wlb add <player>when Floodgate is installed.
GUI
Add Players
The Add Players GUI shows:
Pending players → Online players → Previously joined players
Bedrock players are shown before Java players in the pending and online sections.
Left-click a player to add them to the whitelist.
Shift-click to add all players on the current page.

Whitelisted Players
The whitelist GUI shows the players currently on the server whitelist.
Left-click to remove a player.
Shift-click to remove all players on the current page.

Join notifications
Staff with:
pendingwhitelist.admin
can receive a notification when a non-whitelisted player is rejected.
The notification has clickable actions for managing the request.
There is also a configurable cooldown to prevent repeated attempts from spamming staff.

Commands
| Command | Description |
|---|---|
/wl |
Open the admin dashboard |
/wl add |
Open the Add Players GUI |
/wl add <player...> |
Add players to the whitelist |
/wl list [page] |
List whitelisted players |
/wl remove |
Open the Whitelisted Players GUI |
/wl remove <player...> |
Remove players from the whitelist |
/wl pl [page] |
List pending players |
/wl rpl |
Open the Add Players GUI |
/wl rpl <player...> |
Remove players from pending storage |
/wlb add <player...> |
Add Bedrock players to the whitelist |
/wl on |
Enable the server whitelist |
/wl off |
Disable the server whitelist |
/wl reload |
Reload the plugin configuration |
/wl version |
Check for a newer stable release |
/wlb is available when Floodgate is installed.
All administration commands require:
pendingwhitelist.admin
Configuration
The plugin currently has settings for:
- Debug logging
- Chat page size
- Join-attempt notifications
- Notification cooldown
- Automatic cleanup of old pending requests
Full configuration details are available in the configuration guide.
After changing the configuration, use:
/wl reload
Storage
Pending requests are stored locally in:
plugins/PendingWhitelist/pending.json
The normal Minecraft whitelist is still managed by Paper in:
whitelist.json
No separate database is required.
Requirements
- Paper or Purpur
- Minecraft 1.20+
- Java 17+
Optional
- Floodgate for Bedrock support
- SkinsRestorer for offline-mode skin lookups
Installation
- Stop the server.
- Put the PendingWhitelist JAR in the
pluginsfolder. - Start the server.
- Edit
plugins/PendingWhitelist/config.ymlif needed. - Run
/wl.
That's all that's required.
bStats
PendingWhitelist uses bStats for anonymous plugin statistics.
bStats can be disabled through its global configuration.
Support
For bugs and feature requests, open an issue on GitHub.
Source code is available on the GitHub repository.
PendingWhitelist
A small addition to the normal whitelist system that keeps track of the people who tried to get in.
下载 Pending Whitelist
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Pending Whitelist
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Pending Whitelist
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Pending Whitelist
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Pending Whitelist
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Pending Whitelist
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Pending Whitelist
下载 Pending Whitelist
下载 Pending Whitelist
下载 Pending Whitelist
2.2.4
新增
- 为服务器操作员添加了白名单绕过功能。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧