快速上手 - lmxdg/ZeroLogin GitHub Wiki

快速上手

本页用最短的步骤让你和玩家跑通 ZeroLogin。


玩家视角

首次进入 —— 注册

玩家进入服务器后会看到:

[ZeroLogin] 请先注册:/register <密码> <密码>

输入(两次密码需一致,默认最短 6 位):

/register mypassword mypassword

注册成功后自动完成登录:

[ZeroLogin] 注册成功,已自动登录。

再次进入 —— 登录

提示变为:

[ZeroLogin] 请登录:/login <密码>

输入:

/login mypassword

登录前会发生什么?

在完成认证前,玩家无法:

  • 移动(可以转动视角)
  • 聊天 / 执行命令(仅放行登录相关命令)
  • 破坏 / 放置方块
  • 右键交互 / 丢弃物品
  • 打开背包 / 点击背包物品
  • 受到伤害

若超时未登录(默认 60 秒),会被踢出。


管理员视角

查看状态

/zerologin info
/zerologin stats

重载配置

修改 config.yml 或语言文件后:

/zerologin reload

storage.type 的切换不受 reload 影响,需要迁移数据并重启,见下文与 账号数据。

迁移账号数据(file ↔ sqlite)

/zerologin migrate file sqlite
/zerologin migrate sqlite file

目标后端已有数据时命令会中止以防覆盖;确认无误后加 force(会先自动导出文本备份)。

让某玩家免登录

为玩家添加 zerologin.bypass 权限(例如使用 LuckPerms):

/lp user <玩家名> permission set zerologin.bypass true

该权限会让玩家跳过全部认证,请仅授予可信人员。

玩家忘记密码

默认(SQLite)后端:停止服务端后在 zerologin.db 中删除该账号行:

DELETE FROM accounts WHERE name_lc = '<玩家名小写>';

若使用 file 后端,删除该玩家的账号文件:

plugins/ZeroLogin/accounts/<玩家UUID>.txt

注意:这会一并丢失该账号的 IP 白名单等数据,玩家下次进入需重新注册。


玩家自助:IP 自动登录

已登录玩家可把自己的当前 IP 加入白名单,之后从该 IP 进入免登录:

/ip add 1.2.3.4
/ip list
/ip remove 1.2.3.4
/ip clear

每个账号最多保存 5 个 IP。

安全权衡:同一 IP 下的其他玩家可能借道进入。对安全要求高的服务器,建议在 配置说明 中关闭 session.ip-auto-login。


下一步: 命令与权限 · 配置说明 · 常见问题

⚠️ **GitHub.com Fallback** ⚠️