PremiumConnector - 正版UUID修复器

💡简介

本插件可帮助您在代理服务器上解析正版玩家的 UUID，并允许离线（破解版）玩家在您的服务器上游玩，同时不损害服务器安全。您可以将离线玩家重定向到指定的、安装了 AuthMe 等注册插件的子服进行验证。

🎮功能特性

• UUID 与皮肤修复：为正版玩家修复 UUID 和皮肤显示。
• 用户名冲突处理：当 secondAttempt 设置启用时，使用正版用户名的离线玩家仍可尝试连接。
• 玩家重定向：将使用非正版用户名的离线玩家重定向到指定的验证服务器。
• GeyserMC 兼容：自动将 GeyserMC 连接的玩家识别为正版玩家。
• 多语言支持：目前支持英语和法语，欢迎提交更多翻译。

支持的验证插件

• AuthMe
• LockLogin

> 注意：您需要将您的验证插件配置为与 BungeeCord 协同工作。

🔧命令与权限

• /premium|prem <玩家>

将指定玩家定义为正版用户。

权限：premiumconnector.command.premium

• /cracked|crack <玩家>

将指定玩家定义为离线（破解版）用户。

权限：premiumconnector.command.cracked

• /reset|rst <玩家>

重置指定玩家的状态。

权限：premiumconnector.command.reset

拥有 premiumconnector.admin 权限的玩家可以对其他玩家使用上述命令。

✨配置说明

# 调试等级
debug: INFO
# 语言 (en, fr)
locale: en
# 用于重定向离线玩家进行注册/登录的服务器名称
authServer: crack

# 后端数据库配置
backend:
  # 数据库驱动：SQLite (org.sqlite.JDBC), MySQL (com.mysql.cj.jdbc.Driver) 或 MariaDB (org.mariadb.jdbc.Driver)
  # 如需使用 SQLite，您需要自行安装驱动
  driver: 'com.mysql.cj.jdbc.Driver'
  # 数据库主机地址
  host: '127.0.0.1'
  # 数据库端口
  port: '3306'
  # 数据库用户名
  user: username
  # 数据库密码
  password: password
  # 数据库名称（SQLite 则为数据库文件名）
  database: database
  # 数据表名
  table: premium
  # 连接是否使用 SSL
  useSSL: true

# 是否允许离线玩家使用正版用户名进行二次连接尝试
secondAttempt: true
# 是否阻止玩家在登录前切换服务器
blockServerSwitch: true
# 确认 /premium 命令的等待时间（秒）
timeToConfirm: 30
# 是否为正版玩家设置真实的 UUID？适用于在已有数据的服务器上安装本插件
fixUUID: true
# 信任代理地址列表（谨慎使用！）。从此列表地址连接的玩家无需验证。可用于配置 Geyser 代理地址，如 127.0.0.1 或 172.18.0.*（支持通配符匹配）
geyserProxy: []

❓常见问题

登录流程如何工作？

• 玩家登录您的 BungeeCord 代理。
• PremiumConnector 尝试加载玩家数据：

- 如果存在，从缓存的 PlayerSession 中读取。

- 如果存在，从数据库中读取并缓存。

- 否则，创建新的 PlayerSession，缓存并保存到数据库。

• 使用 Mojang API 检查玩家是否为正版：

- **是**：启动正版登录流程，如果最终未被踢出，则将其重定向到请求的服务器。

- **否**：将玩家重定向到 `authServer` 指定的验证服务器。

• 玩家通过验证插件（AuthMe 或 LockLogin）完成身份验证，然后被重定向到请求的服务器。

如何在此插件中使用 SQLite？

BungeeCord 默认不支持 SQLite。如需使用，您需要：

• 自行安装 SQLite 驱动。
• 在配置中将 driver 设置为 org.sqlite.JDBC。
• 请参考 SQLite 支持指南 或 此 Gist 了解详细步骤。

💡重要警告

• 服务器模式：您必须在离线模式下运行 Spigot 服务器和 BungeeCord。
• 信息转发：如需修复 UUID 和皮肤，您必须通过 BungeeCord 转发玩家信息。
• 数据丢失风险：如果在安装此插件前已有正版玩家在服务器上游玩，由于 UUID 变更，他们将会丢失所有原有数据。

⭐支持与反馈

请通过 [Github Issues](Github Issues) 报告错误或请求新功能（例如支持新的验证插件）。