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
? 安装指南
独立服务器
- 从 Modrinth、SpigotMC 或官方 Discord 下载
CraftersLogin-3.0.jar。
- 将其放入服务器的
plugins/ 文件夹中。
- 同样在
plugins/ 中安装 ProtocolLib 5.x。
- 重启服务器。所有配置文件将自动生成。
- 编辑
plugins/CraftersLogin/config.yml 并配置您的数据库和设置。
- 使用
/cl spawn set <type> 设置出生点。
- 任何配置更改后运行
/cl reload —— 无需重启服务器。
代理网络 (BungeeCord / Velocity)
- 将
CraftersLogin-3.0.jar 放置在每个后端服务器上(不要放在代理本身)。
- 在所有后端服务器上配置一个共享 MySQL 数据库,以便同步账户数据。
- 如果您希望跨代理的会话持久化,请设置
network-sessions.storage: REDIS。
- 插件会自动检测您的代理类型 —— 不需要额外的代理端插件。
从 AuthMe / nLogin 迁移
- 运行
/cl import authme jdbc:mysql://host/database(或 nlogin)。
- 该命令会将所有账户流式传输到 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
CraftersLogin
The Ultimate Authentication System for Minecraft Networks
Paper & Spigot 1.13 – 1.21.x · Java 17+ · Requires ProtocolLib 5.x
What is CraftersLogin?
CraftersLogin is a professional, production-grade authentication plugin for Minecraft servers. It covers the full authentication lifecycle — from first registration to premium auto-login, 2FA for staff, and cross-proxy session synchronization — all inside a single JAR.
Whether you run a solo cracked survival server or a large network with BungeeCord/Velocity, CraftersLogin adapts automatically, requires zero configuration to detect your proxy setup, and scales from a lightweight H2 local database to a full MySQL + Redis cluster.
★ Core Features
? Authentication Modes
CraftersLogin provides two distinct authentication interfaces, selectable via authentication.type in config.yml:
- CHAT — Classic mode. Players type
/login <password> or /register <password> <confirm> in chat. Works with all clients, no dependencies required.
- SIGN — A native Minecraft Sign editor opens when the player runs
/login or /register. Powered by ProtocolLib — the sign is never actually placed in the world. The player types their full alphanumeric password using the keyboard and clicks Done. This completely bypasses chat, making chat-logger hacked clients useless. On registration, the sign opens twice for password confirmation.
? Smart Proxy Auto-Detection
The plugin automatically detects whether it is running as Standalone, behind BungeeCord/Waterfall, or behind Velocity — by silently reading paper-global.yml and spigot.yml at startup. No manual proxy configuration is needed. The plugin adapts its networking and session behavior on its own.
- Velocity (3.x+) — Full support with dedicated plugin-channel communication.
- BungeeCord / Waterfall — Full support via
BungeeCord and bungeecord:main channels.
- Standalone — Works out of the box with no proxy configuration.
⛏️ Bedrock / GeyserMC Support
CraftersLogin detects GeyserMC using silent Reflection instead of a hard floodgate-api dependency. Bedrock players are detected and handled without any dependency conflicts or NoClassDefFoundError errors.
? Spawn Management System
A dedicated spawn management system with five independent spawn types:
| Type |
When it triggers |
auth |
When an unauthenticated player joins |
register |
When a new unregistered player joins |
join |
After any player successfully logs in |
firstjoin |
After a player's very first successful registration |
respawn |
When a player respawns after death |
Spawn points are saved in spawns.yml and managed via /cl spawn set <type>.
? Self-Service Password Recovery
Players can recover their accounts without staff intervention:
/recovery set <email> — Link a recovery email to your account.
/recovery request — Request a 6-digit PIN sent to your email via SMTP.
/recovery confirm <pin> <newpassword> — Verify the PIN and set a new password.
Powered by an embedded JavaMail / SMTP mailer. Compatible with Gmail, Outlook, and any custom SMTP server.
? Cross-Server Session Synchronization
Players authenticated on one backend server stay authenticated when switching to another — no re-login required.
- MEMORY — Default. Fast, zero-dependency, works for single-proxy setups.
- REDIS — Session state persisted in Redis using
SETEX with configurable TTL. Required for high-availability multi-proxy networks. Automatically falls back to MEMORY if Redis is unavailable.
?️ Database Import — Migration from Other Plugins
The /cl import <plugin> <jdbc-url> command streams accounts directly from another plugin's database into CraftersLogin:
- AuthMe — Full account import from SQLite or MySQL.
- nLogin — Full account import from SQLite or MySQL.
- BCrypt passwords migrate 1:1 with no re-hashing required.
- SHA-based passwords import safely and are flagged for automatic upgrade upon the player's next login.
? Player Isolation During Authentication
Until a player authenticates, they are fully sandboxed from the rest of the server:
- Chat and most commands are blocked.
- Movement is restricted.
- The player is invisible to all authenticated players.
- The player's inventory is cleared and securely stored. It is fully restored upon login.
All isolation features are individually configurable in config.yml.
? PlaceholderAPI Integration
Full PAPI expansion registered under %crafterslogin_*%. Exposes registration status, last IP, login count, 2FA status, session data and more to scoreboards, chat plugins, and any PAPI-compatible plugin.
? CraftersStaff Synergy Bridge
When CraftersStaff is installed alongside CraftersLogin, the two plugins automatically coordinate during the authentication flow. A staff member's Staff Mode and Vanish states are suspended until login is complete, then transparently restored — without any staff member having to manually toggle their tools.
?️ Security Systems
BCrypt Password Hashing
All passwords are stored using BCrypt with 12 rounds by default — an industry standard designed to be computationally expensive and resistant to GPU-based cracking.
Password Complexity Rules
- Minimum length (default 8 characters).
- Requires at least one number.
- Requires at least one special character.
- Prevents using the player's username as a password.
Have I Been Pwned (HIBP) Integration
When enabled, every new password is checked against the Have I Been Pwned database of over 800 million compromised passwords. Only the first 5 characters of the SHA-1 hash are sent (k-Anonymity) — the full password never leaves your server.
Graduated Brute Force Protection
3 failed attempts — Staff members with crafterslogin.notify receive an alert in chat.
5 failed attempts — The IP is temporarily banned for a configurable number of minutes.
10 failed attempts — The IP is permanently banned (configurable).
Captcha Verification
An item-based CAPTCHA (no external URLs, no images) can be triggered:
- Adaptive mode — Only presented to suspicious IPs (new IPs or IPs with recent failures).
- Universal mode — Every unauthenticated player must pass the CAPTCHA on every join.
Anti-Alt Account System
Limits the number of accounts that can be registered from the same IP address. Configure whitelisted-ips to exempt cybercafes, shared networks, or university connections.
Staff Secret Answer Challenge
Staff members (players with crafterslogin.staff.security) are required to set a secret answer on first login. If they connect from a new or different IP, they must answer this challenge before regaining access — a highly effective anti-account-theft layer that requires no phone or external app.
GeoIP Country Blocking for Staff
Staff accounts can be restricted to only connect from a configured list of allowed countries. Uses any user-supplied GeoIP API endpoint — no external service is hard-coded.
TOTP Two-Factor Authentication for Staff
An optional TOTP-based 2FA system for staff using Google Authenticator or Authy:
/2fa start — Generate a QR code / secret key to enroll.
/2fa confirm <code> — Verify and activate 2FA.
/2fa verify <code> — Enter the code on login.
/2fa requestremove — Request removal, which sends an alert to online admins.
Designed to be non-mandatory to reduce friction for your staff team.
AFK Session Timeout for Staff
Staff sessions expire after a configurable period of inactivity. When the timeout triggers, the player is logged out and must re-authenticate. This limits exposure if a staff member leaves their computer unattended.
? Commands
Player Commands
| Command |
Description |
/register <password> <confirm> |
Create a new account |
/login <password> |
Log in to your account |
/changepassword <old> <new> <confirm> |
Change your account password |
/unregister <password> |
Delete your account from the server |
/premium |
Enable automatic Mojang/Microsoft account verification |
/offline |
Revert to password authentication (cracked mode) |
/recovery set <email> |
Link a recovery email to your account |
/recovery request |
Request a 6-digit recovery PIN via email |
/recovery confirm <pin> <newpassword> |
Verify PIN and set a new password |
/2fa start |
Begin 2FA enrollment (staff only) |
/2fa confirm <code> |
Activate 2FA with the code from your authenticator |
/2fa verify <code> |
Enter 2FA code on login |
/2fa requestremove |
Request 2FA removal (notifies admins) |
/securityanswer <answer> |
Answer the IP-change staff security challenge |
/setsecurityanswer <answer> |
Set your staff security secret answer |
Admin Commands — /crafterslogin or /cl
| Command |
Description |
Permission |
/cl reload |
Reload all configuration files |
crafterslogin.admin.reload |
/cl version |
Display current plugin version |
crafterslogin.admin.version |
/cl info <player> |
View account details for a player |
crafterslogin.admin.info |
/cl accounts |
Show total registered accounts |
crafterslogin.admin.accounts |
/cl forcelogin <player> |
Force a player to be authenticated |
crafterslogin.admin.forcelogin |
/cl forcelogout <player> |
Force a player out of their session |
crafterslogin.admin.forcelogout |
/cl changepass <player> <newpass> |
Change a player's password as admin |
crafterslogin.admin.changepass |
/cl unregister <player> |
Unregister a player's account |
crafterslogin.admin.unregister |
/cl delete <player> |
Permanently delete an account from the database |
crafterslogin.admin.delete |
/cl dupeip <player> |
View all accounts sharing the same IP |
crafterslogin.admin.dupeip |
/cl purge <days> |
Remove accounts inactive for X days |
crafterslogin.admin.purge |
/cl spawn set <type> |
Set a spawn point (auth/register/join/firstjoin/respawn) |
crafterslogin.admin.spawns |
/cl spawn unset <type> |
Remove a configured spawn point |
crafterslogin.admin.spawns |
/cl spawn teleport <type> |
Teleport to a configured spawn point |
crafterslogin.admin.spawns |
/cl spawn list |
List all configured spawn points |
crafterslogin.admin.spawns |
/cl import <plugin> <jdbc> |
Import accounts from AuthMe or nLogin |
crafterslogin.admin |
/cl migratedb |
Migrate data between database engines |
crafterslogin.admin.migratedb |
/cl 2fa approve <player> |
Approve a staff member's 2FA removal request |
crafterslogin.admin.2fa |
? Permissions
crafterslogin.admin — Full access to all /cl subcommands (OP by default)
├── 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 — Enables IP challenge, 2FA, GeoIP restrictions (OP)
crafterslogin.2fa — Allows the player to use the /2fa system (OP)
crafterslogin.notify — Receives brute-force alerts and update notifications (OP)
crafterslogin.bypass — Skips all authentication entirely (false by default)
crafterslogin.bypass.ip-limit — Bypasses the max-accounts-per-IP limit (OP)
crafterslogin.help — View the /cl help menu (all players)
⚙️ Configuration Reference
Database
database:
type: "H2" # H2 | MYSQL | MARIADB | SQLITE
host: "127.0.0.1"
port: 3306
database: "crafterslogin"
username: "root"
password: ""
Authentication Mode
authentication:
type: "CHAT" # CHAT | SIGN
Security
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
spawns:
force-auth-spawn: true
use-multiverse-core: true
isolate-inventories-until-login: true
hide-players-while-unauthenticated: true
Network Sessions
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
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
Password Recovery (Email)
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
? Installation
Standalone Server
- Download
CraftersLogin-3.0.jar from Modrinth, SpigotMC, or the official Discord.
- Place it in your server's
plugins/ folder.
- Install ProtocolLib 5.x in
plugins/ as well.
- Restart the server. All configuration files are generated automatically.
- Edit
plugins/CraftersLogin/config.yml and configure your database and settings.
- Set spawn points with
/cl spawn set <type>.
- Run
/cl reload after any configuration change — no restart needed.
Proxy Network (BungeeCord / Velocity)
- Place
CraftersLogin-3.0.jar on every backend server (not on the proxy itself).
- Configure a shared MySQL database on all backend servers so accounts are synchronized.
- Set
network-sessions.storage: REDIS if you want cross-proxy session persistence.
- The plugin automatically detects your proxy type — no additional proxy-side plugin is needed.
Migrating from AuthMe / nLogin
- Run
/cl import authme jdbc:mysql://host/database (or nlogin).
- The command streams all accounts into CraftersLogin. BCrypt passwords transfer perfectly, SHA passwords are flagged for upgrade.
?️ Compatibility
| Category |
Supported |
| Server software |
Paper, Spigot (1.13 – 1.21.x) |
| Proxy software |
Velocity 3.x, BungeeCord, Waterfall |
| Java |
17 minimum (Java 21 recommended) |
| Bedrock |
GeyserMC (via silent Reflection) |
| Required |
ProtocolLib 5.x |
| Optional |
PlaceholderAPI, CraftersFastAuth, CraftersStaff |
| Databases |
H2 (embedded), MySQL, MariaDB, SQLite |
| Session storage |
Memory (default), Redis |
© 2026 Crafters Development — All rights reserved.
Redistribution or modification of this software without express written permission is prohibited.
Protected under Chilean Intellectual Property Law 17.336.
Developed by xUnknowns · craftersdevelopment.pages.dev
评论 0
登录后参与评分
还没有评论,来抢沙发吧