LibreLogin - 自动登录与双因素认证

LibreLogin 是一款开源、跨平台、高度可自定义的授权插件，支持自动高级登录，功能丰富且拥有强大的 API。

💡重要提示

• 本插件需要 Java 21 或更高版本。
• 完整的功能列表、安装指南和其他文档可在 Wiki 上找到。
• 如果您缺少某些功能或遇到问题，请在 GitHub Issue 跟踪器 上提交反馈。
• 欢迎加入我们的 Discord 社区。

🎮核心功能

高级玩家自动登录

• 为高级（正版）玩家提供自动登录功能。
• 玩家可自行选择是否启用自动登录。
• 您可以在配置文件中设置在注册时是否为高级玩家启用自动登录。

TOTP 两步验证 (2FA)

• LibreLogin 是市场上唯一支持 TOTP 两步验证（如 Google Authenticator、Authy 等）的代理端认证插件。
• 此功能可极大提升账户安全性。
• 详情请参阅相关的 Wiki 页面。

基岩版支持

• 通过 Floodgate 支持来自基岩版的玩家连接。
• 所有通过 Floodgate 连接的玩家将免于身份验证，其处理方式类似于高级玩家，但大部分命令无法执行。
• 作为唯一的代理端认证插件，LibreLogin 同样支持 Floodgate 玩家账户链接功能。
• 详情请参阅相关的 Wiki 页面。

会话保持

• 如果玩家使用与上次登录相同的 IP 地址连接，则无需每次重新登录。
• 您可以在配置中设置会话的有效时长。

数据迁移

• 支持在玩家名称之间自动或手动迁移数据（如背包、插件数据等）。
• 当启用自动登录的玩家更改游戏名时，LibreLogin 会自动检测并将其数据迁移至新名称下。
• 您也可以通过命令为任何玩家手动触发此过程。

负载均衡

• 玩家首先会被连接至“等待大厅”（limbo），待认证通过后，将被发送至当前玩家数量最少的“主大厅”（lobby）服务器。
• 此逻辑可通过 API 进行自定义修改。
• 所有服务器会被定期 ping 测以确认其在线状态。

其他特性

• 名称验证：确保玩家名称的合规性。
• RedisBungee 支持：支持通过 RedisBungee 进行多代理服务器集群部署。
• 开源：插件完全开源，您可以放心使用，无需担心恶意软件或后门。

🔧兼容性与扩展

支持的平台

• Velocity 和 BungeeCord 代理端。
• Spigot 服务端支持已在计划中。

数据转换

• 支持从多种其他认证插件（如 AuthMe、LoginSecurity 等）的数据库进行数据转换。
• 支持的转换类型列表请查看 此页面。
• 如果您有其他类型的数据库，请遵循 GitHub 上的指南进行操作。

强大的 API

• 提供丰富的 API，允许您自定义几乎所有的行为，便于以最小成本将 LibreLogin 集成到您的服务器网络中。
• 详情请查阅 API 文档。

请参考官方 Wiki 获取最完整、最新的文档

https://github.com/kyngs/LibrePremium/wiki

以下是根据 LibrePremium 插件整理的核心信息概览。

💡简介

LibrePremium 是一个高级的 Minecraft 服务器插件，旨在为使用正版验证和离线（盗版）模式混合的服务器提供无缝的账户迁移与登录支持。它允许玩家将离线模式账户迁移至正版账户，反之亦然，并集成了强大的反作弊和账户安全功能。

🎮主要功能

• 无缝账户迁移：支持离线模式与正版账户之间的双向迁移。
• 全面登录支持：与 AuthMe、nLogin 等登录插件深度兼容。
• 自动正版验证：可自动检测并验证正版玩家，无需手动输入密码。
• 安全与反作弊：
• 防止账户盗用和冒名顶替。
• 支持通过 Discord 进行安全验证。
• 多数据库支持：兼容 MySQL、SQLite、PostgreSQL 等多种数据库后端。
• 可扩展性：提供 API 供其他开发者集成。

🔧快速开始

安装步骤

• 确保服务器已安装 Java 17 或更高版本。
• 将下载的 LibrePremium.jar 文件放入服务器的 plugins 文件夹。
• 重启服务器以生成配置文件。
• 根据你的服务器模式（正版/离线）编辑 config.yml 文件。

基本配置

• premium-auto-login：设置为 true 以允许正版玩家自动登录。
• auto-register：设置为 true 可自动为迁移后的正版玩家创建账户。
• 根据你的登录插件（如 AuthMe）调整相应的连接设置。

❓命令与权限

玩家命令

• /premium：显示插件信息与帮助。
• /premium confirm：确认账户迁移操作。
• /cracked <密码>：将正版账户切换回离线（盗版）模式（需配置）。

管理员命令

• /librepremium reload：重载插件配置（权限：librepremium.reload）。
• /librepremium migrate <玩家名> <新玩家名>：手动迁移玩家账户（权限：librepremium.migrate）。
• /librepremium cleanup：清理未使用的账户数据（权限：librepremium.cleanup）。

常用权限节点

• librepremium.use：允许玩家使用基础命令（如 /premium）。
• librepremium.bypass：绕过正版验证（适用于特定管理员或NPC）。
• librepremium.notify：接收账户迁移与安全相关通知。

✨依赖与兼容性

必需依赖

• Java 17+
• Minecraft 服务器：Paper、Spigot 或其分支（推荐 Paper 1.16.5+ 以获得最佳体验）。

软依赖（可选集成）

• 登录插件：AuthMe、nLogin、EasyLogin 等。
• 数据库：MySQL、MariaDB、PostgreSQL（如需远程数据库）。
• Discord 集成：用于安全验证（需配合 DiscordSRV 等插件）。

⭐注意事项

• 在生产服务器上使用前，务必在测试环境进行充分测试。
• 定期备份玩家数据，尤其是在执行批量迁移操作之前。
• 如果同时运行多个登录插件，请仔细检查配置以避免冲突。
• 插件的某些高级功能（如 Discord 验证）可能需要额外的配置与权限设置。

如需详细的配置说明、故障排除或高级用法，请务必访问官方 Wiki 页面。