快速上手 - 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 影响,需要迁移数据并重启,见下文与 账号数据。
/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 add 1.2.3.4
/ip list
/ip remove 1.2.3.4
/ip clear
每个账号最多保存 5 个 IP。
安全权衡:同一 IP 下的其他玩家可能借道进入。对安全要求高的服务器,建议在 配置说明 中关闭
session.ip-auto-login。