PkLogin

插件

· 作者 Pumpkings

下一个最好的登录插件。

0 本站下载 0 关注 更新于 3 个月前

最新 2.0-Velocity · 26.2 · Velocity

一键开服(送7天)
PkLogin

PkLogin

一款专为 Spigot、Paper、Folia 和 Velocity 打造的安全、现代且功能丰富的身份验证插件。


? AI 使用披露

AI 工具被用于辅助 代码开发、翻译以及本 README/文档的编写。


✨ 功能

? 身份验证

  • 支持 Paper、Folia & Velocity。
  • 已验证账号自动登录 — 在成功验证所有权后,经过身份验证的 Minecraft 账号可以在不创建本地密码的情况下加入服务器。
  • 登录会话 — 在可配置的时间段内,对于受信任的重连跳过密码输入。
  • 暴力破解保护 — 限制失败的登录尝试次数。
  • IP 账号数量限制 — 控制单个 IP 地址可以注册的账号数量。
  • 登录超时 — 自动断开未通过身份验证的玩家连接。
  • Limbo 系统 — 在通过身份验证之前,禁止玩家移动、使用命令和聊天。
  • 安全传送 — 在登录前将玩家传送到安全位置,并在之后恢复其之前的位置。
  • 用户名冲突处理 — 防止不同账号模式和 UUID 模式之间的冲突。

?️ Velocity 集成

  • 零手动代理配置 — PkLogin 会自动检测网络的转发配置。
  • 已验证代理消息 — 使用源自 Velocity 现代转发密钥的 HMAC 签名。
  • 后端验证 — 代理可以验证身份验证服务器是否正在运行 PkLogin 并使用相同的签名密钥。
  • 需要 Velocity 现代转发 才能实现安全的已验证账号自动登录。

? 密码安全

支持多种哈希算法:

算法 用途
BCrypt 推荐的默认值
Argon2id 强密码哈希
PBKDF2 600,000 次迭代
SHA-512 / SHA-256 加盐兼容模式
AuthMe SHA256 只读迁移支持

自动哈希迁移: 随时更改配置的算法。现有的受支持密码哈希会被自动检测,并在玩家下次成功登录后重新哈希。

? 双因素身份验证 (2FA)

  • Discord 2FA,基于 DM 的验证码。
  • 一次性使用的 6 位验证码。
  • 验证码在 5 分钟 后过期,且尝试次数有限。
  • 计划在未来的版本中添加其他 2FA 方法。

?️ 数据库支持

  • SQLite — 默认,零配置
  • H2
  • MySQL
  • MariaDB
  • PostgreSQL

? 迁移

AuthMe → PkLogin

/pklogin authme-import

导入现有账号,同时保留受支持的密码、IP 信息和注册日期。

数据库迁移

/pklogin migrate <engine>

在不删除原始数据的情况下,在支持的数据库引擎之间移动账号。

现有账号会被跳过,这使得迁移操作可以安全地重复执行。

? 国际化

内置 20+ 种语言,包括:

英语、西班牙语、葡萄牙语、法语、德语、俄语、中文、波兰语、意大利语、土耳其语、越南语等。

? UUID 模式

选择如何处理账号 UUID:

  • REAL — 使用经过身份验证的 Minecraft 账号 UUID。
  • RANDOM — 生成随机 UUID。
  • OFFLINE — 使用 Minecraft 标准的离线 UUID 生成方式。

?️ 安全性

PkLogin 的设计围绕 默认的安全身份验证 展开。

已验证账号自动登录

PkLogin 可以验证符合条件的 Minecraft 账号,并允许它们在不创建单独 PkLogin 密码的情况下加入服务器。

对于未知用户名,PkLogin 可以查询 Mojang 的账号服务,并在适用时执行标准的 Minecraft 在线身份验证握手。

成功的身份验证提供了对连接账号的加密验证。

如果外部账号服务暂时不可用,PkLogin 可以使用服务器配置的本地身份验证行为,而不是依赖未经在线验证的身份验证结果。

在独立的 Paper 服务器上,已验证账号自动登录需要 PacketEvents 或 ProtocolLib。Velocity 会自动处理所需的代理端身份验证流程。

登录会话

会话允许已通过身份验证的玩家无需再次输入密码即可重新连接。

Security:
  session:
    enable: true
    timeout: 5

会话具有以下特性:

  • 有时限
  • 绑定到玩家的 IP 地址
  • 一次性使用
  • 仅存储在内存中

当密码或 2FA 设置更改、账号被删除或 PkLogin 重载时,它们会自动失效。

安全提示: IP 地址并非唯一的身份标识。请保持会话超时时间较短,尤其是在共享网络上。


?️ 命令

玩家命令

命令 描述
/login <password> 登录
/register <pass> <confirm> 注册本地账号
/changepassword <old> <new> 修改密码
/unregister <password> 删除本地凭证
/premium confirm 启用已验证的 Minecraft 账号模式
/offline 切换到本地账号模式
/2fa discord 链接 Discord 2FA
/2fa verify2fa <code> 验证 2FA 验证码

管理员命令

每个命令都有各自的权限。

命令 描述
/pklogin help 显示管理员命令
/pklogin reload 重载配置
/pklogin authme-import 导入 AuthMe 账户
/pklogin migrate <engine> 迁移数据库引擎
/pklogin forcelogin <user> 强制玩家登录
/pklogin unregister <user> 移除玩家的本地密码
/pklogin delete <user> 永久删除一个账户
/pklogin changepass <user> <pass> 更改玩家的密码
/pklogin verify <user> 查看账户信息
/pklogin dupeip <ip/user> 查找共享同一 IP 的账户
/pklogin setspawn 设置预登录出生点
/pklogin update 下载最新版本

⚙️ 配置

PkLogin 高度可配置,同时保持设置简单。

Security:
  time-to-login: 45
  hash-algorithm: BCRYPT

  password:
    small: 5
    large: 15

  session:
    enable: true
    timeout: 5

autologin:
  premium:
    enable: true
    cache-minutes: 60

  bedrock:
    enable: true
    skip-register: true

passwords:
  bruteforce:
    max-login-tries: 3

security:
  ip-limit:
    enable: true
    limit: 3

teleport:
  safe-location: true
  last-location: true

limbo:
  blindness-effect: false

username-appender:
  enabled: false

? 代理设置

PkLogin 不需要额外的代理密钥或 proxy-mode 选项。

当运行在 Velocity 后端时,PkLogin 会自动读取网络已使用的转发配置,并从 Velocity 的现代转发密钥中派生出单独的签名密钥。

这提供了:

  • 安全的代理 → 后端认证
  • 防止伪造的认证消息
  • 自动后端兼容性检查
  • 无需在多个配置文件中重复密钥

对于生产网络,强烈推荐使用 Velocity 现代转发 + 防火墙保护后端端口。


? Discord 双重验证 (2FA)

配置:

# plugins/PkLogin/2fa/discord.yml

enable: false

authentication:
  token: "YOUR_BOT_TOKEN_HERE"

使用以下命令绑定账户:

/2fa discord

然后将生成的验证码发送给配置的 Discord 机器人。


? 从 AuthMe 迁移

  1. 将您的 authme.db 放置于:
plugins/AuthMe/authme.db
  1. 运行:
/pklogin authme-import

PkLogin 会异步导入兼容的账户,并保留其支持的现有密码哈希。

在可能的情况下,成功登录后会自动将哈希迁移到配置的哈希算法。


? 许可证

MIT License — © 2020–2026 PkLogin Contributors

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源