安装指南 - lmxdg/ZeroLogin GitHub Wiki
安装指南
本页介绍 ZeroLogin 的环境要求、安装、升级与卸载。
一、环境要求
| 项目 | 要求 |
|---|---|
| 服务端 | Paper / Spigot 1.20 ~ 26.1.2 及其衍生服务端 |
| Java | 17 或更高（跟随你的服务端所需版本即可） |
| 服务端模式 | online-mode=false（离线模式 / 盗版服） |
ZeroLogin 面向离线模式服务器。若你的服务器可开启正版验证（
online-mode=true），通常不需要登录插件。
二、安装
方式一：下载成品 JAR（推荐）
- 打开 Releases 页面 下载最新版
ZeroLogin.jar - 关闭服务端
- 把 JAR 放入服务端的
plugins/目录 - 启动服务端
首次启动后，插件会在 plugins/ZeroLogin/ 生成：
plugins/ZeroLogin/
├── config.yml # 主配置
├── zerologin.db # SQLite 数据库（默认后端，注册后出现）
├── messages_zh_cn.yml # 简体中文消息
├── messages_zh_tw.yml # 繁體中文消息
├── messages_en_us.yml # 英文消息
├── messages_ja_jp.yml # 日本語メッセージ
├── messages_ko_kr.yml # 한국어 메시지
├── messages_ru_ru.yml # Русские сообщения
├── messages_es_es.yml # Mensajes en español
└── accounts/ # 仅 file 后端使用
方式二：从源码构建
git clone https://github.com/lmxdg/ZeroLogin.git
cd ZeroLogin
mvn clean package
构建产物位于 target/ZeroLogin-<版本>.jar，复制到 plugins/ 即可。详见 开发与构建。
三、验证安装成功
服务端启动日志中应出现类似输出：
[ZeroLogin] ZeroLogin x.x.x 已启用，存储后端=sqlite，兼容 Minecraft 1.20 ~ 26.1.2
也可在控制台或游戏内执行：
/zerologin info
应显示插件版本、兼容区间与存储后端。
四、升级
- 关闭服务端
- 用新版 JAR 替换
plugins/下的旧 JAR（删除旧文件，避免同名残留） - 启动服务端
配置与账号数据位于
plugins/ZeroLogin/，替换 JAR 不会影响它们。升级后如需应用新默认配置项，请手动比对config.yml。
从 v1.0 升级到 v1.1.0
v1.1.0 默认使用 SQLite 存储。按上面的常规步骤替换 JAR 后，首次启动时插件会自动把 accounts/ 下的 v1.0 账号导入数据库（非破坏式，原文件保留）：
[ZeroLogin] 已把 N 个账号从文本文件导入 SQLite，原 accounts/ 目录未修改。
若想继续用文件后端，把 config.yml 中 storage.type 保持/改为 file 即可。详见 账号数据 的后端切换说明。
五、卸载
- 关闭服务端
- 删除
plugins/ZeroLogin.jar - 如需彻底清除数据，再删除
plugins/ZeroLogin/目录
⚠️ 删除
plugins/ZeroLogin/会永久丢失所有账号数据，请先备份（见 账号数据）。
六、多服务器部署
若多台服务端需要共享账号：
- file 后端：把各服的
plugins/ZeroLogin/accounts/指向同一存储（共享目录 / 定期同步），注意并发写入风险 - sqlite 后端：适合「整库复制」部署（把
zerologin.db复制到新服），不适合多服并发读写同一文件
多服实时共享计划由后续 MySQL 后端解决。