文本描述
PAL — Player Advanced Login
PAL 是一款免费、开源的适用于 Bukkit 兼容 Minecraft 服务器的身份验证插件。它涵盖了账号注册、密码登录、正版身份处理、基岩版身份支持、会话管理、登录前限制、数据迁移、占位符、LuckPerms 上下文以及可选的代理会话桥接功能。
测试版通知: PAL
0.1.0旨在用于预发布环境和受控的测试网络。请在与您实际服务器环境完全一致的环境中测试,并在将其部署到公开的生产网络之前保留数据库和配置的备份。
PAL 的功能
PAL 在身份验证完成之前保护您的服务器。没有经过验证的正版身份的玩家可以注册并使用密码登录;仅当所有权得到实际验证时,正版玩家才会被信任;而 Bedrock(基岩版)玩家则通过 Floodgate/Geyser 进行检测。
它既适用于小型单服务器设置,也适用于大型代理网络。在单服务器上,PAL 可以使用 SQLite 运行。在网络中,PAL 可以通过 Redis 或共享 SQL 数据库与可选的 PAL Proxy 插件同步签名会话。
PAL 是一款身份验证和账户安全插件。它不提供、推广或认可盗版 Minecraft 副本,也不会绕过任何 Mojang 或微软的所有权检查。
主要特性
- 密码账号注册与登录。
- 仅通过已验证来源进行正版自动登录:Bukkit online-mode、FastLogin 或 PAL Proxy 登录阶段验证。
- 通过 Floodgate/Geyser 处理基岩版身份。
- 针对离线模式网络的混合正版与密码账号行为。
- PBKDF2-SHA256 密码哈希,并在登录时自动重新哈希。
- 可配置的密码策略:长度限制、用户名屏蔽、常用密码屏蔽以及重复注册确认。
- 持久化的身份验证会话,支持可选的 IP 和用户名绑定。
- TOTP 双因素认证(2FA),附带备用恢复码。
- 登录前限制:移动、聊天、命令、物品栏、掉落物、拾取、伤害、方块操作和传送。
- 逻辑上的 AUTH、LOBBY 和 LIMBO 领域,各自拥有独立的限制、出生点和效果。
- 支持 SQLite、MySQL、MariaDB 和 PostgreSQL 存储。
- 网络会话的 Redis 或共享 SQL 桥接。
- 支持从 AuthMe、nLogin、OpeNLogin、LibreLogin、LoginSecurity 和 FastLogin 导入数据。
- PlaceholderAPI 扩展支持。
- LuckPerms 运行时上下文。
- 用于账号与会话生命周期变更的 Bukkit API 事件。
- 完全可配置的命令、别名、权限和消息。
支持的集成
- FastLogin — 基于验证的正版登录决策。
- Floodgate/Geyser — 基岩版身份检测。
- PlaceholderAPI —
%pal_*%占位符。 - LuckPerms — 认证/会话/存储运行时上下文。
- PAL Proxy — Velocity/BungeeCord 网络防护与会话移交。
玩家命令
| 命令 | 别名 | 权限 |
|---|---|---|
/login <password> |
/l |
pal.command.login |
/register <password> <password> |
/reg |
pal.command.register |
/changepassword <old-password> <new-password> |
/changepw, /cpw |
pal.command.changepassword |
/logout |
无 | pal.command.logout |
/unregister confirm |
无 | pal.command.unregister |
/premium confirm |
无 | pal.command.premium |
/offline confirm |
无 | pal.command.offline |
/pal2fa <code/setup/confirm/disable/recover> |
/2fa |
pal.command.2fa |
管理员命令
管理员根命令为 /pal,别名为 /palauth。
/pal info/pal reload/pal help/pal account <player>/pal session <player>/pal session clear <player>/pal force-login <player>/pal force-logout <player>/pal reset-password <player> <password>/pal unregister <player>/pal migrate <provider>/pal migrate all
管理员权限按操作划分,包括 pal.admin、pal.admin.reload、pal.admin.session、pal.admin.force-login、pal.admin.force-logout、pal.admin.reset-password、pal.admin.unregister 和 pal.admin.migrate。
占位符与上下文
PAL 包含 PlaceholderAPI 值,例如认证状态、会话来源、会话过期时间、2FA 状态、桥接模式、存储类型、FastLogin 可用性和 Floodgate 可用性。
当安装了 LuckPerms 时,PAL 可以暴露以下上下文:
pal:authenticatedpal:session_sourcepal:2fa_pendingpal:bridge_modepal:storage_type
安装
单服务器
- 将
PAL-<version>.jar放入您的 Bukkit/Paper/Foliaplugins文件夹中。 - 启动服务器一次。
- 查看
plugins/PAL/security.yml、storage.yml、premium.yml、commands.yml和messages.yml。 - 对于小型单服务器安装,请保持
storage.type: SQLITE。 - 测试
/register <password> <password>和/login <password>。
网络设置
- 在 Bukkit 认证/大厅服务器(auth/lobby server)上安装 PAL。
- 在 Velocity 或 BungeeCord 上安装 PAL Proxy。
- 使用远程 SQL 存储账号和会话数据。
- 推荐使用 Redis 作为签名会话桥接,若不可用则使用 DATABASE 模式。
- 确保 Bukkit 端和代理端的
bridge.sec.secret设置一致。 - 对后端服务器进行防火墙保护,并使用代理转发密钥。
重要安全说明
PAL 不会将 Mojang 名称查询视为正版所有权的证明。仅当连接通过 Bukkit 在线模式、FastLogin 或 PAL Proxy 验证时,才信任正版自动登录。
对于生产网络,请尽可能使用 MySQL/MariaDB/PostgreSQL 和 Redis。SQLite 仅适用于单服务器环境或受控测试,不适用于多后端的生产网络。
PAL 的后端防护不能替代防火墙。请务必通过适当的网络规则和代理转发配置来保护后端服务器。
支持
如需帮助,请提供您的服务器软件/版本、PAL 版本、存储类型、桥接模式、代理软件、已安装的集成插件以及相关日志。请勿在评论区域寻求技术支持;请先使用配置好的支持渠道。
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
自定义你的Minecraft头像!
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧