World ID - 真人验证与权限管理

借助 Worldcoin 的 World ID，验证您的玩家是真实人类且仅拥有一个账户，并为他们分配 LuckPerms 中的角色！

您可以根据玩家验证通过的 World ID 验证等级，为其创建不同的用户组。World ID Orb 提供了最强的人格唯一性证明，它使用保护隐私的生物识别技术，确保无人能拥有两个账户。World ID Device 则确保用户拥有唯一的移动设备，在易于玩家获取的同时，提供了强大的机器人防御能力。

💡核心功能

• 唯一人类验证：使用 World ID 确保每位玩家都是独特的真实人类，有效防止多账户和机器人。
• 无缝权限集成：验证成功后，自动为玩家分配您在 LuckPerms 中预设的权限组。
• 多级验证支持：根据不同的验证等级（Orb 或 Device）授予不同权限，实现精细化管理。
• 隐私保护：World ID 采用零知识证明技术，验证过程无需收集或存储玩家的个人生物信息。

🎮工作原理

验证流程

• 玩家在游戏中执行命令，获取一个唯一的验证链接。
• 玩家使用 World App 扫描链接中的二维码或打开链接完成验证。
• 插件确认验证成功后，根据其验证等级自动更新该玩家的 LuckPerms 组。
• 玩家获得相应组别的权限，享受对应的游戏内容。

验证等级说明

• Orb 验证：玩家通过 Orb 设备进行虹膜扫描验证。这是最高安全等级，能近乎 100% 保证人格唯一性，适合授予高级或特权权限组。
• Device 验证：玩家通过已安装 World App 的智能手机验证。此等级保证了设备的唯一性，能有效阻挡大部分机器人，适合作为基础玩家组的验证方式。

🔧配置与管理

基本设置

您需要在配置文件中设置以下核心信息

• worldcoin-app-id: 您在 Worldcoin 开发者门户注册的应用 ID。
• verification-levels: 为 orb 和 device 等级分别指定对应的 LuckPerms 组名。

命令列表

• /worldid verify - 生成一个属于该玩家的、一次性的验证链接。
• /worldid reload - 重载插件配置文件（需管理员权限）。

权限节点

• worldid.verify - 允许玩家使用验证命令。
• worldid.admin - 允许使用重载等管理命令。

✨安装与需求

前置需求

• 服务器：运行 Paper、Spigot 或其衍生服务端（1.16.5+）。
• 依赖插件：LuckPerms。
• Worldcoin 开发者账户：您需要前往 Worldcoin Developer Portal 注册并创建一个应用，以获取 APP_ID。

安装步骤

• 将插件 Jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 编辑生成的配置文件 (plugins/WorldIDLuckPerms/config.yml)，填入您的 app_id 并设置验证等级与权限组的映射关系。
• 在 LuckPerms 中创建配置文件中指定的权限组，并设置好相应的权限。
• 重载插件配置或重启服务器，即可开始使用。

本插件可通过编辑服务器 plugins/WorldId 目录下的 config.yml 文件进行配置。以下是可用的设置项：

🎮配置项说明

server-uuid

• server-uuid: ""
• 用于代表您服务器的唯一标识符。若不填写，系统将自动生成一个。
• 注意：初始设置后请勿随意更改，除非您希望所有用户重新进行验证。

orb-group-name

• orb-group-name: "humans"
• 指定通过 World ID Orb 验证的用户将被授予的 LuckPerms 组名。
• Orb 凭证提供极高可信度，确保用户为真人且仅拥有一个账户。

device-group-name

• device-group-name: ""
• 指定通过 World ID Device 验证的用户将被授予的 LuckPerms 组名。
• World ID Lite 凭证验证用户拥有唯一的移动设备，提供中等强度的机器人防护，同时易于使用。

web-url

• web-url: " https://minecraft.worldcoin.org "
• 用户进行 World ID 验证的网页界面地址。
• 除非出于开发目的本地运行该界面，否则不应更改此 URL。

💡重要提示

• orb-group-name 与 device-group-name 中至少必须设置一项。
• 若仅设置 orb-group-name，则只有通过 Orb 验证的用户会被加入该组。
• 若仅设置 device-group-name，则通过 Device 或 Orb 验证的用户均会被加入该组。