文本描述
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:authenticated
pal:session_source
pal:2fa_pending
pal:bridge_mode
pal:storage_type
安装
单服务器
- 将
PAL-<version>.jar 放入您的 Bukkit/Paper/Folia plugins 文件夹中。
- 启动服务器一次。
- 查看
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 版本、存储类型、桥接模式、代理软件、已安装的集成插件以及相关日志。请勿在评论区域寻求技术支持;请先使用配置好的支持渠道。
Text Description
PAL — Player Advanced Login
PAL is a free, open-source authentication plugin for Bukkit-compatible Minecraft servers. It covers account registration, password login, premium identity handling, Bedrock identity support, sessions, pre-auth restrictions, migrations, placeholders, LuckPerms contexts and optional proxy session bridging.
Beta notice: PAL 0.1.0 is intended for staging and controlled beta networks. Test it with your exact server stack and keep database/config backups before using it on a public production network.
What PAL does
PAL protects your server before authentication is complete. Players without a verified premium identity register and log in with a password, premium players are trusted only when ownership is actually verified, and Bedrock players are detected through Floodgate/Geyser.
It is designed for both small single-server setups and larger proxy networks. On a single server, PAL can run with SQLite. On a network, PAL can sync signed sessions through Redis or a shared SQL database with the optional PAL Proxy addon.
PAL is an authentication and account-security plugin. It does not provide, promote or endorse pirated copies of Minecraft, and it does not bypass any Mojang or Microsoft ownership check.
Main features
- Password account registration and login.
- Premium auto-login through verified sources only: Bukkit online-mode, FastLogin, or PAL Proxy login-phase verification.
- Bedrock identity handling through Floodgate/Geyser.
- Hybrid premium and password account behavior for offline-mode networks.
- PBKDF2-SHA256 password hashing with automatic rehash on login.
- Configurable password policy: length limits, username blocking, common-password blocking and repeated registration confirmation.
- Persistent auth sessions with optional IP and username binding.
- TOTP two-factor authentication with backup recovery codes.
- Pre-auth restrictions for movement, chat, commands, inventory, drops, pickups, damage, block actions and teleports.
- Logical AUTH, LOBBY and LIMBO realms with separate restrictions, spawn points and effects.
- SQLite, MySQL, MariaDB and PostgreSQL storage.
- Redis or shared SQL bridge for network sessions.
- Importers for AuthMe, nLogin, OpeNLogin, LibreLogin, LoginSecurity and FastLogin.
- PlaceholderAPI expansion.
- LuckPerms runtime contexts.
- Bukkit API events for account and session lifecycle changes.
- Fully configurable commands, aliases, permissions and messages.
Supported integrations
- FastLogin — verified premium login decisions.
- Floodgate/Geyser — Bedrock identity detection.
- PlaceholderAPI —
%pal_*% placeholders.
- LuckPerms — auth/session/storage runtime contexts.
- PAL Proxy — Velocity/BungeeCord network guarding and session handoff.
Player commands
| Command |
Alias |
Permission |
/login <password> |
/l |
pal.command.login |
/register <password> <password> |
/reg |
pal.command.register |
/changepassword <old-password> <new-password> |
/changepw, /cpw |
pal.command.changepassword |
/logout |
none |
pal.command.logout |
/unregister confirm |
none |
pal.command.unregister |
/premium confirm |
none |
pal.command.premium |
/offline confirm |
none |
pal.command.offline |
/pal2fa <code/setup/confirm/disable/recover> |
/2fa |
pal.command.2fa |
Admin commands
The admin root command is /pal, with /palauth as an alias.
/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
Admin permissions are split by action, including pal.admin, pal.admin.reload, pal.admin.session, pal.admin.force-login, pal.admin.force-logout, pal.admin.reset-password, pal.admin.unregister and pal.admin.migrate.
Placeholders and contexts
PAL includes PlaceholderAPI values such as authentication state, session source, session expiry, 2FA state, bridge mode, storage type, FastLogin availability and Floodgate availability.
When LuckPerms is installed, PAL can expose contexts such as:
pal:authenticated
pal:session_source
pal:2fa_pending
pal:bridge_mode
pal:storage_type
Installation
Single server
- Put
PAL-<version>.jar in your Bukkit/Paper/Folia plugins folder.
- Start the server once.
- Review
plugins/PAL/security.yml, storage.yml, premium.yml, commands.yml and messages.yml.
- Keep
storage.type: SQLITE for small single-server installs.
- Test
/register <password> <password> and /login <password>.
Network setup
- Install PAL on the Bukkit auth/lobby server.
- Install PAL Proxy on Velocity or BungeeCord.
- Use remote SQL for accounts and sessions.
- Use Redis for the recommended signed session bridge, or DATABASE mode when Redis is not available.
- Set the same
bridge.sec.secret on Bukkit and proxy.
- Firewall backend servers and use proxy forwarding secrets.
Important security notes
PAL does not treat a Mojang name lookup as proof of premium ownership. Premium auto-login is trusted only when the connection is verified by Bukkit online-mode, FastLogin, or PAL Proxy.
For production networks, use MySQL/MariaDB/PostgreSQL and Redis where possible. SQLite is intended for single-server setups or controlled tests, not multi-backend production networks.
PAL's backend guard is not a firewall replacement. Always protect backend servers with proper network rules and proxy forwarding configuration.
Support
If you need help, include your server software/version, PAL version, storage type, bridge mode, proxy software, installed integrations and relevant logs. Do not use review sections for support; use the configured support channel first.
评论 0
登录后参与评分
还没有评论,来抢沙发吧