✦ LunnaraLogin ✦
Lunnara Network 的认证插件
Spigot · Paper · Purpur · 所有分支版本 · 1.21.x · 安全 BCrypt · MiniMessage 样式
支持的平台
| 平台 |
状态 |
| Paper 1.21.x |
✔ 完全支持(原生 Adventure) |
| Spigot 1.21.x |
✔ 完全支持(阴影化/打包 Adventure) |
| Purpur 1.21.x |
✔ 完全支持 |
| Pufferfish 1.21.x |
✔ 完全支持 |
| 任意 Spigot/Paper 分支 |
✔ 开箱即用 |
需要 Java 21 或更高版本。
功能
- BCrypt 密码哈希 — 密码经过安全加盐与哈希处理,绝不以明文形式存储
- MiniMessage 支持 — 所有消息均可通过渐变、颜色和格式进行完全自定义
- 全面锁定 — 在通过身份验证之前,玩家无法移动、聊天、交互、建造或受到伤害
- 失明效果 — 可选的登录前失明与缓慢效果
- 自动踢出 — 超时未完成认证的玩家将被踢出
- 登录提醒 — 定期发送消息提醒玩家使用
/login 或 /register
- JSON 存储 — 每个玩家独立的数据文件,无需数据库
- 异步操作 — 密码哈希在主线程之外运行,零延迟
命令
玩家命令
| 命令 |
别名 |
描述 |
/register <password> <password> |
/reg |
注册新账号(首次加入时) |
/login <password> |
/l |
登录你的账号 |
/changepass <old> <new> |
/changepassword |
修改你自己的密码 |
管理员命令
所有管理员命令均使用 /lunaralogin(别名:/ll, /llogin)
| 命令 |
权限节点 |
描述 |
/ll changepass <player> <newpass> |
lunaralogin.admin.changepass |
强制更改玩家的密码 |
/ll delacc <player> |
lunaralogin.admin.delacc |
删除玩家的账号(若在线则踢出) |
/ll forcelogin <player> |
lunaralogin.admin.forcelogin |
强制让在线玩家登录(无需密码) |
/ll status <player> |
lunaralogin.admin.status |
检查玩家是否已注册/已登录 |
/ll reload |
lunaralogin.admin.reload |
重载配置与消息文件 |
权限
| 权限节点 |
默认值 |
描述 |
lunaralogin.admin |
OP |
访问管理员帮助 |
lunaralogin.admin.changepass |
OP |
更改其他玩家的密码 |
lunaralogin.admin.delacc |
OP |
删除玩家的账号 |
lunaralogin.admin.forcelogin |
OP |
强制登录玩家 |
lunaralogin.admin.status |
OP |
查看玩家认证状态 |
lunaralogin.admin.reload |
OP |
重载配置文件 |
配置
config.yml
| 选项 |
默认值 |
描述 |
session-timeout |
60 |
会话持续时间(分钟) |
login-timeout |
120 |
未认证玩家被踢出前的秒数 |
max-login-attempts |
5 |
踢出玩家前的最大失败尝试次数 |
min-password-length |
6 |
最小密码长度 |
max-password-length |
32 |
最大密码长度 |
allow-movement-before-auth |
false |
允许在登录前移动 |
blind-before-auth |
true |
在认证前施加失明与缓慢效果 |
reminder-interval |
5 |
登录/注册提醒之间的间隔秒数 |
allowed-commands |
/login, /register, /l, /reg |
认证前可使用的命令 |
messages.yml
所有消息均使用 MiniMessage 格式。支持渐变、十六进制颜色、粗体等。
默认配置中的示例:
login-success: "<color:#ff7ae6>✔ <color:#ffffff>登录成功! <color:#aaaaaa>欢迎回来。"
安装
- 构建插件:
cd LunnaraLogin && ./gradlew build
- 将
build/libs/LunnaraLogin-1.0.0.jar 复制到服务器的 plugins/ 文件夹中
- 启动服务器 —— 配置文件将自动生成
- 根据需要编辑
config.yml 和 messages.yml
- 运行
/ll reload 以应用更改
工作原理
- 首次加入 — 玩家被冻结并致盲,提示输入
/register <password> <password>
- 再次访问 — 玩家被冻结并致盲,提示输入
/login <password>
- 成功后 — 移除效果,授予完整的服务器访问权限
- 速度太慢? — 超过
login-timeout 秒后被踢出
- 密码错误? — 达到
max-login attempts 次失败尝试后被踢出
玩家数据存储在 plugins/LunnaraLogin/playerdata/<uuid>.json 中。
Lunnara Network · Spigot / Paper / Purpur · 1.21.x · Java 21
✦ LunnaraLogin ✦
Authentication plugin for Lunnara Network
Spigot · Paper · Purpur · All Forks · 1.21.x · Secure BCrypt · MiniMessage Styled
Supported Platforms
| Platform |
Status |
| Paper 1.21.x |
✔ Fully supported (native Adventure) |
| Spigot 1.21.x |
✔ Fully supported (shaded Adventure) |
| Purpur 1.21.x |
✔ Fully supported |
| Pufferfish 1.21.x |
✔ Fully supported |
| Any Spigot/Paper fork |
✔ Should work out of the box |
Requires Java 21 or higher.
Features
- BCrypt Password Hashing — Passwords are securely salted & hashed, never stored in plain text
- MiniMessage Support — All messages fully customizable with gradients, colors & formatting
- Full Lockdown — Players can't move, chat, interact, build, or take damage until authenticated
- Blindness Effect — Optional blindness + slowness applied before login
- Auto Kick — Players who don't authenticate within the timeout get kicked
- Login Reminders — Periodic messages reminding players to
/login or /register
- JSON Storage — Per-player data files, no database needed
- Async Operations — Password hashing runs off the main thread, zero lag
Commands
Player Commands
| Command |
Aliases |
Description |
/register <password> <password> |
/reg |
Register a new account (first join) |
/login <password> |
/l |
Log in to your account |
/changepass <old> <new> |
/changepassword |
Change your own password |
Admin Commands
All admin commands use /lunaralogin (aliases: /ll, /llogin)
| Command |
Permission |
Description |
/ll changepass <player> <newpass> |
lunaralogin.admin.changepass |
Force-change a player's password |
/ll delacc <player> |
lunaralogin.admin.delacc |
Delete a player's account (kicks if online) |
/ll forcelogin <player> |
lunaralogin.admin.forcelogin |
Force-login an online player without a password |
/ll status <player> |
lunaralogin.admin.status |
Check if a player is registered / logged in |
/ll reload |
lunaralogin.admin.reload |
Reload config & messages |
Permissions
| Permission |
Default |
Description |
lunaralogin.admin |
OP |
Access to admin help |
lunaralogin.admin.changepass |
OP |
Change another player's password |
lunaralogin.admin.delacc |
OP |
Delete a player's account |
lunaralogin.admin.forcelogin |
OP |
Force-login a player |
lunaralogin.admin.status |
OP |
View player auth status |
lunaralogin.admin.reload |
OP |
Reload configuration |
Configuration
config.yml
| Option |
Default |
Description |
session-timeout |
60 |
Session duration in minutes |
login-timeout |
120 |
Seconds before unauthenticated players are kicked |
max-login-attempts |
5 |
Failed login attempts before kick |
min-password-length |
6 |
Minimum password length |
max-password-length |
32 |
Maximum password length |
allow-movement-before-auth |
false |
Allow movement before logging in |
blind-before-auth |
true |
Apply blindness + slowness before auth |
reminder-interval |
5 |
Seconds between login/register reminders |
allowed-commands |
/login, /register, /l, /reg |
Commands usable before authenticating |
messages.yml
All messages use MiniMessage formatting. Supports gradients, hex colors, bold, etc.
Example from the default config:
login-success: "<color:#ff7ae6>✔ <color:#ffffff>Logged in successfully! <color:#aaaaaa>Welcome back."
Installation
- Build the plugin:
cd LunnaraLogin && ./gradlew build
- Copy
build/libs/LunnaraLogin-1.0.0.jar to your server's plugins/ folder
- Start the server — config files will be generated
- Edit
config.yml and messages.yml to your liking
- Run
/ll reload to apply changes
How It Works
- First join — Player is frozen & blinded, prompted to
/register <password> <password>
- Return visit — Player is frozen & blinded, prompted to
/login <password>
- On success — Effects removed, full server access granted
- Too slow? — Kicked after
login-timeout seconds
- Wrong password? — Kicked after
max-login-attempts failed tries
Player data is stored in plugins/LunnaraLogin/playerdata/<uuid>.json.
Lunnara Network · Spigot / Paper / Purpur · 1.21.x · Java 21
评论 0
登录后参与评分
还没有评论,来抢沙发吧