CaelLabAuth 登录认证
自研
Paper 1.21+
JDK 21+
CaelLab 自研登录插件。离线服没有 Mojang 帮忙验证身份，谁都能用你的名字连上来——所以要登录。第一次连接会弹出 Paper 原生对话框让你粘贴网站给你的 20 位密钥。验证发生在进入世界之前：没过这一关，你拿不到任何世界数据，也不会出现在别的玩家屏幕上。
原生对话框
用 Paper 的 Dialog 弹窗输入密钥，不用记命令
密钥即密码
20 位随机密钥，来自网站绑定角色时生成的那一串
进世界之前就卡住
验证没过，你既看不到世界，也不在别人的屏幕上——光有名字进不来
哈希存储
密钥以哈希形式保存，数据库里没有明文
登录即查封禁
验证通过后立刻查一次封禁状态，违规者当场踢出并给出原因
登录流程
// 1. 用网站绑定的游戏用户名连接服务器
// 2. 这时你还不在世界里：没有世界数据可看，别的玩家也看不到你
// 3. 插件检查该用户名是否已绑定（向网站 API 查询）
// 已绑定 → 弹出密钥输入对话框
// 未绑定 → 弹出注册引导，并给出网站地址
// 4. 提交密钥 → 插件把它发给网站 API 校验
// 5. 校验通过 → 才把你放进世界，解除冻结、检查封禁状态、显示欢迎信息
// 拿别人的名字连上来也停在最前面这一步：名字换不来密钥
// 密钥在网站「绑定角色」时生成，只显示一次，务必保存
// 在网站后台可以重置；重置后旧密钥立即失效
命令与权限
| 命令 | 说明 | 权限 |
|---|---|---|
/key <密钥> | 弹窗弹不出来时的兜底登录方式，正常走对话框就行 | 所有玩家 |
依赖关系
| 依赖 | 必须 | 说明 |
|---|---|---|
| Paper | 是 | Dialog 弹窗需要 Paper 1.21+ |
| 网站认证 API | 是 | 由 minecraft.caellab.com 提供，负责校验密钥与封禁状态 |
怎么拿到密钥
- 在网站用 CaelLabID 登录
- 进入个人后台，绑定你的游戏用户名
- 绑定成功后密钥只显示一次，复制保存好
- 回到游戏，在弹窗里粘贴密钥即可进入服务器
采用 CaelLab BY-SA Code License, Version 3
Copyright (c) 2025 Yunyun(云云)
Copyright (c) 2025 Yunyun(云云)