Home

ZeroLogin

新一代轻量级 Minecraft 服务器登录插件 —— 单个 JAR 兼容 Minecraft 1.20 ~ 26.1.2

ZeroLogin 为离线模式（online-mode=false）服务器提供账号注册与登录保护：玩家首次进入需注册，之后每次进入需登录；在完成认证前，插件会冻结其移动并拦截各类交互，防止未认证玩家破坏服务器。

---

快速导航

页面	内容
安装指南	环境要求、下载与安装、升级与卸载
快速上手	玩家与管理员的最短上手流程
命令与权限	全部命令、别名与权限节点
配置说明	config.yml 逐项详解
账号数据	存储结构、备份与迁移
安全说明	口令散列与安全设计
常见问题	高频问题解答
开发与构建	从源码构建、测试与兼容性门禁
更新日志	版本变更记录

---

核心特性

• 安全口令存储：PBKDF2-HMAC-SHA256 + 随机盐，加密部分零外部依赖
• 全面登录保护：未认证时拦截移动、命令、聊天、方块、交互、战斗、背包
• IP 自动登录：白名单 IP 免登录，支持会话恢复
• 登录防护：超时踢出 + 密码错误次数限制
• SQLite 存储后端：默认单文件数据库（WAL 模式），异步 IO 不阻塞主线程
• 双后端与迁移：file / sqlite 可互换，内置非破坏式迁移，v1.0 老数据自动导入
• 多语言：内置 7 种语言，language: auto 跟随每位玩家的客户端语言
• 改名安全：按 UUID 存储，玩家改名不丢数据

---

兼容性一览

项目	说明
支持版本	Minecraft 1.20 ~ 26.1.2（Paper / Spigot 及其衍生）
单 JAR	一个 JAR 覆盖全区间，无需分版本下载
字节码	编译目标 Java 17（class major 61），可运行于 Java 17 ~ 25
API 使用	仅使用 1.20 与 26.x 两端点共有的 Bukkit API 交集

为什么单 JAR 就能兼容？

1. api-version: '1.20' —— Paper 采用「api-version ≤ 服务端版本即允许加载」的规则，故声明 1.20 可同时被 1.20 与 26.x 加载。
2. 低版本字节码向上兼容 —— 1.20 运行于 Java 17，26.x 运行于 Java 25；Java 17 字节码可直接在 Java 25 JVM 上运行。
3. 只用 API 交集 —— 开发期对 1.20.1 与 26.1.2 两个 API 包做了类与方法签名逐一比对。

---

相关链接

• 仓库：https://github.com/lmxdg/ZeroLogin
• 发布下载：https://github.com/lmxdg/ZeroLogin/releases
• 问题反馈：https://github.com/lmxdg/ZeroLogin/issues
• 开源协议：MIT