原创 二次开发 开源 KaLogin 高级账号安全中心扩展 2026-05-11

KaLogin-AccountCenter​

现代化账号安全中心扩展插件
适用于 Paper 1.21.8+ Dialog API 登录服

KaLogin-AccountCenter（简称 KAC）是一款基于 KaLogin Dialog 登录系统开发的高级账号安全中心扩展插件。

插件专为现代化高版本登录服设计，提供邮箱绑定、邮箱验证码、找回密码、修改密码、账号安全中心等功能，并完整兼容 KaLogin 与 CatSeedLogin 双账户系统。
*使用CatSeedLogin构建高/低版本双登录服的请查看我基于KaLogin修改的CatSeedLogin适配版
KAC 使用 Minecraft 1.21.7+ 原生 Dialog API 构建现代化交互界面，无需传统箱子GUI、铁砧输入或聊天栏输入密码，提供更加自然、统一、高级的登录与账号安全体验。

━━━━━━━━━━━━━━━━━━━━

功能特性​

• 现代化 Dialog API 账号中心界面
• 邮箱绑定 / 更换邮箱
• 邮箱验证码验证
• 找回密码系统
• 修改密码系统
• KaLogin UI 原生风格兼容
• CatSeedLogin 数据库兼容
• KaLogin 原生数据库兼容
• 未登录状态下找回密码
• 玩家协议 / KaMenu 联动
• 支持自定义关闭后执行逻辑
• 支持 Console / Player 指令动作
• 支持账号中心页面配置化
• 支持 SMTP 邮件发送
• 支持阿里企业邮箱 / QQ邮箱等 SMTP 服务

━━━━━━━━━━━━━━━━━━━━

适用场景​

• 高版本现代化登录服
• 1.21.8+ 登录服务器
• KaLogin 登录系统扩展
• CatSeedLogin 升级改造
• KaMenu 玩家协议系统
• 高版本沉浸式登录流程

━━━━━━━━━━━━━━━━━━━━

支持版本​

• Paper 1.21.8+
• Java 21+

━━━━━━━━━━━━━━━━━━━━
KaLogin-AccountCenter 使用方法
━━━━━━━━━━━━━━━━━━━━

一、安装插件​

将以下插件放入服务器 plugins 文件夹：

• KaLogin
• KaLogin-AccountCenter（KAC）
• （可选）KaMenu

启动服务器后，插件会自动生成：

plugins/KaLogin-AccountCenter/
目录结构：

config.yml
center.yml
━━━━━━━━━━━━━━━━━━━━

二、配置账号数据库​

KAC 支持：

• CatSeedLogin 数据库
• KaLogin 原生数据库

在 config.yml 中配置：

CatSeedLogin 模式​

KaLogin 模式​

━━━━━━━━━━━━━━━━━━━━

三、配置邮箱 SMTP​

示例（阿里企业邮箱）：

mail:<br> enabled: true<br><br> smtp-host: 'smtp.qiye.aliyun.com'<br> smtp-port: 465<br><br> ssl: true<br> starttls: false<br><br> username: 'op@example.com'<br> password: 'SMTP授权码'<br><br> from-address: 'op@example.com'<br> from-name: '云墨工艺账号中心'<br>
QQ邮箱示例：

smtp-host: 'smtp.qq.com'<br>smtp-port: 465<br>ssl: true<br>
注意：

password 必须填写 SMTP 授权码，而不是邮箱登录密码。

━━━━━━━━━━━━━━━━━━━━

四、KaLogin 登录界面接入​

在 KaLogin 的登录 UI 中增加：

forgot_password:<br> type: 'message'<br> text: |<br> &lt;gray&gt;忘记密码？点击 &lt;/gray&gt;&lt;text=&lt;aqua&gt;&lt;bold&gt;[ 找回账号 ]&lt;/bold&gt;;hover=&lt;gray&gt;通过绑定邮箱找回密码;command=/kac recover&gt;<br>
作用：

玩家未登录时可直接打开找回密码界面。

━━━━━━━━━━━━━━━━━━━━

五、玩家协议界面接入​

在 KaMenu 玩家协议中增加：

&lt;text=&lt;aqua&gt;&lt;bold&gt;[ 打开账号安全中心 ]&lt;/bold&gt;;hover=&lt;gray&gt;绑定邮箱 / 修改密码 / 安全设置;command=/kac center&gt;<br>
作用：

登录完成后可打开账号安全中心。

━━━━━━━━━━━━━━━━━━━━

六、账号中心功能​

玩家登录后：

/kac
或：

/kac center
即可打开账号安全中心。

支持：

• 绑定邮箱
• 更换邮箱
• 修改密码
• 安全设置
• 返回协议界面

━━━━━━━━━━━━━━━━━━━━

七、未登录状态功能​

KAC 支持：

/kac recover
即使玩家未登录，也可以通过 Dialog API 找回密码。

插件会自动绕过 KaLogin 未登录命令限制。

━━━━━━━━━━━━━━━━━━━━

八、主要指令​

玩家：

/kac
/kac center
/kac bind
/kac recover
/kac change
管理员：

/kac reload
━━━━━━━━━━━━━━━━━━━━

九、自定义账号中心界面​

KAC 支持：

center.yml
配置账号中心页面。

可自定义：

• 页面标题
• 页面文本
• 按钮
• 页面跳转
• 执行动作
• 返回协议界面
• 指令执行

━━━━━━━━━━━━━━━━━━━━

十、自定义关闭后逻辑​

config.yml：

after-actions:<br> center-close:<br> enabled: true<br> command-mode: console<br> commands:<br> - 'km open player_agreement %player%'<br>
作用：

关闭账号中心后自动返回协议页面。

━━━━━━━━━━━━━━━━━━━━

十一、重载配置​

/kac reload<br>
━━━━━━━━━━━━━━━━━━━━

十二、注意事项​

• 仅支持 Paper 1.21.8+
• 需要 Java 21+
• 建议搭配 KaLogin 使用
• 建议搭配 KaMenu 玩家协议系统
• SMTP 邮箱必须开启客户端授权功能
• SQLite 不可 relocate/shade 重定位

━━━━━━━━━━━━━━━━━━━━

推荐登录流程​

KaLogin 登录→ 玩家协议→ KAC 账号中心（可选）→ 主大厅


━━━━━━━━━━━━━━━━━━━━

数据库兼容​

KAC 支持：

• CatSeedLogin accounts.db
• KaLogin 原生数据库

其中：

KaLogin 模式下，邮箱数据默认保存在 KAC 本地数据库中，不会修改 KaLogin 原生用户表结构，仅在重置密码时写入密码字段。

━━━━━━━━━━━━━━━━━━━━

开发说明​

本插件基于 KaLogin 生态开发，部分交互逻辑与设计思路建立在 KaLogin 与 KaMenu 提供的 Dialog API 能力之上。

感谢原作者提供的现代化登录框架支持。

━━━━━━━━━━━━━━━━━━━━

作者​

SenalMC / 云墨工艺