CraftersLogin

插件

· 作者 xUnknowns

为 Minecraft 服务器提供完整的身份验证解决方案,支持高级自动登录、代理支持、暴力破解保护、持久会话以及灵活的数据库选项。

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

最新 3.0 · 1.21 · BungeeCord / Paper

一键开服(送7天)

CraftersLogin Banner

CraftersLogin

Minecraft 网络的终极身份验证系统

Paper & Spigot 1.13 – 1.21.x · Java 17+ · 需要 ProtocolLib 5.x


CraftersLogin 是什么?

CraftersLogin 是一款专业的、面向生产环境的身份验证插件,适用于 Minecraft 服务器。它涵盖了完整的身份验证生命周期——从首次注册、高级自动登录、员工的双重身份验证(2FA),到跨代理会话同步——所有功能均集成在一个 JAR 文件中。

无论你是运行单人破解版生存服,还是拥有 BungeeCord/Velocity 的大型网络,CraftersLogin 都能自动适应。它无需任何配置即可检测你的代理设置,并支持从轻量级的 H2 本地数据库扩展到完整的 MySQL + Redis 集群。


★ 核心特性

? 身份验证模式

CraftersLogin 提供了两种不同的身份验证界面,可通过 config.yml 中的 authentication.type 进行选择:

  • 聊天 — 经典模式。玩家在聊天栏中输入 /login <密码> 或 /register <密码> <确认>。兼容所有客户端,无需额外依赖。

  • SIGN — 当玩家执行 /login 或 /register 命令时,会打开一个原生的 Minecraft 告示牌编辑器。由 ProtocolLib 提供支持——该告示牌实际上并不会放置在世界中。玩家使用键盘输入完整的字母数字密码,然后点击“完成”。这完全绕过了聊天功能,使得聊天记录器和作弊客户端失效。在注册时,告示牌会打开两次以确认密码。

? 智能代理自动检测

该插件自动检测其运行模式是独立服务器、BungeeCord/Waterfall 代理后端,还是 Velocity 代理后端——通过在启动时静默读取 paper-global.yml 和 spigot.yml 实现。无需手动配置代理。插件会自动调整其网络与会话行为。

  • Velocity (3.x+) — 完全支持,使用专用的插件通道通信。
  • BungeeCord / Waterfall — 通过 BungeeCord 和 bungeecord:main 通道完全支持。
  • Standalone — 开箱即用,无需任何代理配置。

⛏️ 基岩版 / GeyserMC 支持

CraftersLogin 使用静默反射而非硬性的 floodgate-api 依赖来检测 GeyserMC。基岩端玩家会被正确识别和处理,不会引发任何依赖冲突或 NoClassDefFoundError 错误。

? 出生点管理系统

一个专用的出生点管理系统,包含五种独立的出生点类型:

类型 触发时机
auth 当未认证的玩家加入时
register 当新的未注册玩家加入时
join 在任何玩家成功登录后
firstjoin 在玩家首次成功注册后
respawn 当玩家在死亡后重生时

出生点保存在 spawns.yml 中,并通过 /cl spawn set <type> 进行管理。

? 自助密码恢复

玩家可以无需工作人员干预地恢复其账户:

  • /recovery set <email> — 将恢复邮箱链接到你的账户。
  • /recovery request — 请求通过 SMTP 向你的邮箱发送一个 6 位数的 PIN 码。
  • /recovery confirm <pin> <newpassword> — 验证 PIN 码并设置新密码。

由内置的 JavaMail / SMTP 邮件发送器提供支持。兼容 Gmail、Outlook 以及任何自定义 SMTP 服务器。

? 跨服务器会话同步

在一个后端服务器上完成认证的玩家,在切换到其他服务器时保持已认证状态——无需重新登录。

  • MEMORY — 默认选项。快速、零依赖,适用于单代理(single-proxy)架构。
  • REDIS — 使用 SETEX 命令将会话状态持久化到 Redis 中,并支持可配置的 TTL。高可用性多代理网络所必需。如果 Redis 不可用,会自动回退到 MEMORY。

?️ 数据库导入 — 从其他插件迁移

/cl import <plugin> <jdbc-url> 命令可将账户数据直接从另一个插件的数据库流式传输到 CraftersLogin:

  • AuthMe — 从 SQLite 或 MySQL 完整导入账户。
  • nLogin — 从 SQLite 或 MySQL 完整导入账户。
  • BCrypt 密码 以 1:1 的比例迁移,无需重新哈希。
  • SHA 基密码 安全导入,并在玩家下次登录时标记为自动升级。

? 认证期间的玩家隔离

在玩家完成认证之前,他们与服务器其余部分完全沙盒隔离:

  • 聊天和大多数命令被禁用。
  • 移动受到限制。
  • 该玩家对所有已认证玩家不可见。
  • 玩家的物品栏被清空并安全存储。登录成功后会完全恢复。

所有隔离功能均可在 config.yml 中单独配置。

? PlaceholderAPI 集成

完整的 PAPI 扩展已注册,标识符为 %crafterslogin_*%。可向记分板、聊天插件及任何兼容 PAPI 的插件暴露注册状态、最后登录 IP、登录次数、2FA 状态、会话数据等信息。

? CraftersStaff 协同桥接

当同时安装了 CraftersStaff 和 CraftersLogin 时,两个插件会在认证流程中自动协调。工作人员的 Staff Mode(员工模式)和 Vanish(隐身)状态会被暂停,直到登录完成后再透明地恢复——无需任何工作人员手动切换工具。


?️ 安全系统

BCrypt 密码哈希 所有密码默认均使用 BCrypt 进行存储,迭代轮数为 12 轮——这是一种行业标准算法,旨在通过较高的计算成本来抵御基于 GPU 的破解攻击。

密码复杂度规则

  • 最小长度(默认为 8 个字符)。
  • 必须包含至少一个数字。
  • 必须包含至少一个特殊字符。
  • 禁止将玩家的玩家名用作密码。

Have I Been Pwned (HIBP) 集成 启用后,每个新密码都会与包含超过 8 亿个泄露密码的 Have I Been Pwned 数据库进行比对。仅发送 SHA-1 哈希值的前 5 个字符(k-匿名性)——完整密码永远不会离开你的服务器。

分级暴力破解防护

  • 3 次失败尝试 — 拥有 crafterslogin.notify 权限的管理员会在聊天中收到警报。
  • 5 次失败尝试 — IP 将被临时封禁,时长可配置(分钟)。
  • 10 次失败尝试 — IP 将被永久封禁(可配置)。

验证码验证 可触发基于物品的验证码(无需外部 URL,无需图片):

  • 自适应模式 — 仅向可疑 IP(新 IP 或近期有失败记录的 IP)展示。
  • 通用模式 — 每位未认证玩家每次加入时都必须通过验证码。

反小号系统 限制同一 IP 地址可以注册的账号数量。配置 whitelisted-ips 以豁免网吧、共享网络或大学连接。

管理员秘密答案挑战 拥有 crafterslogin.staff.security 权限的管理员在首次登录时必须设置一个秘密答案。如果他们从新的或不同的 IP 连接,必须在重新获得访问权限前回答此挑战——这是一种高效的防账号盗窃层,无需手机或外部应用。

管理员 GeoIP 国家/地区屏蔽 管理员账号只能从配置的允许国家/地区列表中连接。使用任何用户提供的 GeoIP API 端点——没有硬编码的外部服务。

管理员 TOTP 双因素身份验证 为使用 Google Authenticator 或 Authy 的管理员提供可选的基于 TOTP 的 2FA 系统:

  • /2fa start — 生成二维码 / 密钥以完成注册。
  • /2fa confirm <code> — 验证并激活 2FA。
  • /2fa verify <code> — 在登录时输入代码。
  • /2fa requestremove — 请求移除,这将向在线管理员发送警报。

设计为非强制性,以减少对管理团队的摩擦。

管理员 AFK 会话超时 管理员会话在一段可配置的不活跃时间后过期。当触发超时时,玩家会被登出并必须重新认证。如果管理员离开电脑无人看管,这可以限制暴露风险。


? 命令

玩家命令

命令 描述
/register <password> <confirm> 创建新账号
/login <password> 登录你的账号
/changepassword <old> <new> <confirm> 更改你的账号密码
/unregister <password> 从服务器删除你的账号
/premium 启用 Mojang/Microsoft 账号自动验证
/offline 回退到密码认证(盗版模式)
/recovery set <email> 将恢复邮箱链接到你的账号
/recovery request 通过邮件请求 6 位恢复 PIN 码
/recovery confirm <pin> <newpassword> 验证 PIN 码并设置新密码
/2fa start 开始 2FA 注册(仅限管理员)
/2fa confirm <code> 使用验证器中的代码激活 2FA
/2fa verify <code> 在登录时输入 2FA 代码
/2fa requestremove 请求移除 2FA(通知管理员)
/securityanswer <answer> 回答 IP 变更的管理员安全挑战
/setsecurityanswer <answer> 设置你的管理员安全秘密答案

管理员命令 — /crafterslogin 或 /cl

命令 描述 权限
/cl reload 重载所有配置文件 crafterslogin.admin.reload
/cl version 显示当前插件版本 crafterslogin.admin.version
/cl info <player> 查看玩家的账号详情 crafterslogin.admin.info
/cl accounts 显示已注册的总账号数 crafterslogin.admin.accounts
/cl forcelogin <player> 强制玩家进行认证 crafterslogin.admin.forcelogin
/cl forcelogout <player> 强制玩家退出会话 crafterslogin.admin.forcelogout
/cl changepass <player> <newpass> 作为管理员更改玩家密码 crafterslogin.admin.changepass
/cl unregister <player> 注销玩家的账号 crafterslogin.admin.unregister
/cl delete <player> 从数据库中永久删除账号 crafterslogin.admin.delete
/cl dupeip <player> 查看共享相同 IP 的所有账号 crafterslogin.admin.dupeip
/cl purge <days> 移除 X 天内不活跃的账号 crafterslogin.admin.purge
/cl spawn set <type> 设置出生点(auth/register/join/firstjoin/respawn) crafterslogin.admin.spawns
/cl spawn unset <type> 移除已配置的出生点 crafterslogin.admin.spawns
/cl spawn teleport <type> 传送至已配置的出生点 crafterslogin.admin.spawns
/cl spawn list 列出所有已配置的出生点 crafterslogin.admin.spawns
/cl import <plugin> <jdbc> 从 AuthMe 或 nLogin 导入账号 crafterslogin.admin
/cl migratedb 在数据库引擎之间迁移数据 crafterslogin.admin.migratedb
/cl 2fa approve <player> 批准管理员的 2FA 移除请求 crafterslogin.admin.2fa

? 权限

crafterslogin.admin              — 完全访问所有 /cl 子命令(默认 OP)
  ├── crafterslogin.admin.reload
  ├── crafterslogin.admin.version
  ├── crafterslogin.admin.info
  ├── crafterslogin.admin.accounts
  ├── crafterslogin.admin.forcelogin
  ├── crafterslogin.admin.forcelogout
  ├── crafterslogin.admin.changepass
  ├── crafterslogin.admin.unregister
  ├── crafterslogin.admin.delete
  ├── crafterslogin.admin.dupeip
  ├── crafterslogin.admin.purge
  ├── crafterslogin.admin.spawns
  ├── crafterslogin.admin.migratedb
  └── crafterslogin.admin.2fa

crafterslogin.staff.security     — 启用 IP 挑战、两步验证 (2FA)、GeoIP 限制(OP)
crafterslogin.2fa                — 允许玩家使用 /2fa 系统(OP)
crafterslogin.notify             — 接收暴力破解警报和更新通知(OP)
crafterslogin.bypass             — 完全跳过所有身份验证(默认关闭)
crafterslogin.bypass.ip-limit    — 绕过每 IP 最大账户数限制(OP)
crafterslogin.help               — 查看 /cl help 菜单(所有玩家)

⚙️ 配置参考

数据库

database:
  type: "H2"   # H2 | MYSQL | MARIADB | SQLITE
  host: "127.0.0.1"
  port: 3306
  database: "crafterslogin"
  username: "root"
  password: ""

认证模式

authentication:
  type: "CHAT"   # CHAT | SIGN

安全设置

security:
  anti-alts:
    enabled: true
    max-accounts-per-ip: 3
    whitelisted-ips:
      - "127.0.0.1"
  password-complexity:
    enabled: true
    min-length: 8
    require-number: true
    require-special-char: true
    prevent-username-as-password: true
  hibp:
    enabled: true
    prevent-pwned-passwords: true
  brute-force:
    enabled: true
    max-attempts-before-warning: 3
    minutes-ban-after-5-fails: 5
    perm-ban-after-10-fails: true
  captcha:
    enabled: true
    require-for-all-unauthenticated: false

出生点

spawns:
  force-auth-spawn: true
  use-multiverse-core: true
  isolate-inventories-until-login: true
  hide-players-while-unauthenticated: true

网络会话

network-sessions:
  enabled: true
  remember-during-proxy-connection: true
  fallback-timeout-minutes: 60
  storage: "MEMORY"   # MEMORY | REDIS
  redis:
    host: "127.0.0.1"
    port: 6379
    password: ""
    database: 0

工作人员安全

staff-security:
  enabled: true
  force-secret-answer: true
  check-ip-change: true
  afk-timeout:
    enabled: true
    minutes: 10
  geoip:
    enabled: true
    api-url: "http://ip-api.com/json/%ip%"
    allowed-countries: []
    strict-ip-lock: false

密码恢复(邮件)

recovery:
  email:
    enabled: true
    host: "smtp.gmail.com"
    port: 587
    username: "your-email@gmail.com"
    password: "your-app-password"
    sender-email: "noreply@yourserver.com"
    sender-name: "CraftersLogin Security"
    use-tls: true

? 安装指南

独立服务器

  1. 从 Modrinth、SpigotMC 或官方 Discord 下载 CraftersLogin-3.0.jar。
  2. 将其放入服务器的 plugins/ 文件夹中。
  3. 同样在 plugins/ 中安装 ProtocolLib 5.x。
  4. 重启服务器。所有配置文件将自动生成。
  5. 编辑 plugins/CraftersLogin/config.yml 并配置您的数据库和设置。
  6. 使用 /cl spawn set <type> 设置出生点。
  7. 任何配置更改后运行 /cl reload —— 无需重启服务器。

代理网络 (BungeeCord / Velocity)

  1. 将 CraftersLogin-3.0.jar 放置在每个后端服务器上(不要放在代理本身)。
  2. 在所有后端服务器上配置一个共享 MySQL 数据库,以便同步账户数据。
  3. 如果您希望跨代理的会话持久化,请设置 network-sessions.storage: REDIS。
  4. 插件会自动检测您的代理类型 —— 不需要额外的代理端插件。

从 AuthMe / nLogin 迁移

  1. 运行 /cl import authme jdbc:mysql://host/database(或 nlogin)。
  2. 该命令会将所有账户流式传输到 CraftersLogin。BCrypt 密码可完美转移,SHA 密码将被标记为需升级。

?️ 兼容性

类别 支持情况
服务端软件 Paper, Spigot (1.13 – 1.21.x)
代理软件 Velocity 3.x, BungeeCord, Waterfall
Java 最低要求 17(推荐 Java 21)
基岩版 GeyserMC(通过静默反射机制)
必需项 ProtocolLib 5.x
可选项 PlaceholderAPI, CraftersFastAuth, CraftersStaff
数据库 H2(嵌入式), MySQL, MariaDB, SQLite
会话存储 内存(默认), Redis

© 2026 Crafters Development — 保留所有权利。
未经明确书面许可,禁止重新分发或修改本软件。
受智利知识产权法 17.336 保护。

由 xUnknowns 开发 · craftersdevelopment.pages.dev

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源