跳到主要内容

EMC 高级登录

EMC 高级登录（EMC-AdvancedLogin）是一款基于 QQ 授权的 Minecraft 服务器登录插件，取代传统的密码登录方式，为玩家提供更安全、更便捷的登录体验。

主要功能​

  • QQ 扫码登录 — 玩家进服后点击聊天中的链接，通过 QQ 授权完成身份验证
  • 联合封禁检查 — 登录时自动查询 EMC 中央用户数据库的封禁状态
  • 本地封禁管理 — 管理员通过 GUI 菜单封禁/解封在线玩家
  • AuthMe 数据继承 — 自动检测旧 AuthMe 账号，支持密码验证后继承数据
  • 离线密码设置 — 新玩家登录后可设置离线备用密码
  • 状态保护系统 — 登录前保存玩家全部状态到文件，防止崩溃导致数据丢失
  • 行为限制 — 未登录玩家禁止移动、交互、破坏、聊天和执行命令

环境要求​

项目要求
服务端Paper/Spigot/CatServer 1.12.2+
JavaJava 8+
可选依赖AuthMe（数据继承功能）
网络需要连接 EMC 中央 QQ 用户数据库 API

安装步骤​

  1. 从下载页面获取 EMC-AdvancedLogin-1.0-SNAPSHOT.jar
  2. 将 jar 文件放入服务器的 plugins/ 目录
  3. 启动服务器，插件会自动生成配置文件
  4. 编辑 plugins/EMC-AdvancedLogin/config.yml 配置管理员 QQ ID
  5. 重载配置或重启服务器

工作原理​

玩家进入服务器
    ↓
保存玩家状态（背包/经验/生命值等）→ 持久化到文件
    ↓
清空玩家状态，设置冒险模式 + 隐身
    ↓
请求登录 API，获取 QQ 授权链接
    ↓
发送可点击链接给玩家
    ↓
轮询检查授权状态（默认每 3 秒）
    ↓
QQ 授权成功 → 检查联合封禁 → 检查本地封禁
    ↓
（如有 AuthMe 旧账号）验证旧密码 → 继承数据
（如无旧账号）设置离线密码
    ↓
恢复玩家状态，登录完成

注意事项​

  • 插件启动时会自动禁用 AuthMe，由本插件接管全部登录流程
  • 如果服务器崩溃，玩家重连时会自动从文件恢复之前保存的状态
  • 需要确保服务器能够访问 EMC 中央 QQ 用户数据库 API（103.254.150.216）