命令与权限 - lmxdg/ZeroLogin GitHub Wiki

命令与权限


命令一览

命令 别名 说明 需登录
/register <密码> <密码> /reg 注册账号,成功后自动登录 否
/login <密码> /l 登录账号 否
/unregister <当前密码> /unreg 注销(删除)账号 是
/changepassword <旧密码> <新密码> /changepw /cpw 修改密码 是
/ip <add|remove|list|clear> [ip] — 管理自动登录 IP 是
/zerologin <reload|info|stats|migrate|lang-template> /zl 管理命令 —

"需登录"表示该命令受未认证保护拦截;未认证时执行会被提示「请先登录后再执行该命令」。


/register

/register <密码> <密码>
  • 两次输入必须一致
  • 密码长度需在 min-password-length ~ max-password-length 之间
  • 若开启 require-mixed,密码需同时包含字母与数字
  • 注册成功后自动登录

/login

/login <密码>
  • 密码错误会提示剩余尝试次数
  • 超过 max-login-attempts 次后自动踢出

/unregister

/unregister <当前密码>
  • 需已登录
  • 校验当前密码通过后删除账号

/changepassword

/changepassword <旧密码> <新密码>
  • 需已登录
  • 新密码同样受长度与强度规则约束

/ip 子命令

子命令 说明
/ip add <ip> 添加自动登录 IP,每个账号上限 5 个
/ip remove <ip> 移除指定自动登录 IP
/ip list 列出已保存的自动登录 IP
/ip clear 清空全部自动登录 IP

需 zerologin.ip 权限(默认所有人拥有)。

/zerologin 子命令

子命令 说明
/zerologin reload 重载 config.yml 与语言文件
/zerologin info 显示插件版本、兼容区间、存储后端与数据来源
/zerologin stats 显示注册账号数与当前在线已认证人数
/zerologin migrate <from> <to> [force] 在 file 与 sqlite 之间迁移账号数据(异步执行);目标非空时需显式 force,force 前自动导出文本备份
/zerologin lang-template <lang> 导出指定语言的内置消息模板,便于翻译自定义

需 zerologin.admin 权限(默认 OP)。所有子命令支持 Tab 补全。


权限节点

权限节点 默认 说明
zerologin.admin OP 使用 /zerologin 管理命令
zerologin.bypass 否 免登录,进入服务器后无需认证
zerologin.ip 是 使用 /ip 管理自己的自动登录 IP
zerologin.* OP 包含以上全部权限

说明

  • zerologin.* 默认授予 OP,且其子节点 zerologin.bypass 也会随之生效。若只想给管理员管理命令而不给免登录,可单独授予 zerologin.admin。
  • 使用权限插件(LuckPerms 等)按需分配。示例:
/lp group default permission set zerologin.ip true
/lp user Steve permission set zerologin.bypass true
/lp group admin permission set zerologin.admin true

相关: 配置说明 · 安全说明

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