<!> EasyWhitelist - EasyWhitelist

💡Easy Whitelist

你是否遇到过这种情况：明明已经将自己加入了服务器的白名单，但尝试加入时却提示“你不在白名单上”？Easy Whitelist 插件就是为了解决这个经典的服务器启动困境而设计的。它提供了一个更可靠的白名单机制，让你无需反复开关原版白名单，就能轻松管理玩家准入。

❓它如何工作？

原版 Minecraft 的白名单系统有一个限制：它需要玩家至少成功连接过一次服务器，其 UUID 才会被记录在案。对于一个全新的、从未有玩家加入过的服务器，即使你在控制台输入 /whitelist add <你的名字>，系统也无法识别这个名字对应的玩家，导致你仍然无法加入。

Easy Whitelist 采用了不同的方式。它主要依据玩家的游戏ID（即用户名）来进行验证，绕过了原版系统对 UUID 的初始依赖，从而解决了上述“先有鸡还是先有蛋”的难题。

典型问题场景

• 你创建了一个全新的服务器。
• 服务器是纯净的，没有任何玩家加入过，也没有任何管理员或插件。
• 你开启了原版白名单，并在控制台将自己加入白名单。
• 当你尝试加入时，却收到“你不在白名单上”的错误。

传统解决方案（繁琐）

• 关闭原版白名单。
• 加入服务器。
• 重新开启原版白名单。
• 再次将自己加入白名单。

每当有新玩家需要加入时，你可能都需要重复这个过程。

使用 Easy Whitelist 后（简化）

• 在新服务器上安装本插件。
• 关闭原版白名单（/whitelist off）。
• 执行 /easywl add <你的名字> 将自己加入插件白名单。
• 执行 /easywl on 开启插件白名单功能。
• 完成！现在你可以直接加入服务器。

🎮指令与权限

主要指令

• /easywl - 查看插件帮助信息。

权限节点

管理本插件需要以下权限

• easywhitelist.admin

---

资源图标由 Smartline 设计。