先给结论
基岩版权限体系由两个 JSON 文件构成:allowlist.json 决定准入,permissions.json 决定管理级别。两者都以玩家 XUID 为键,手工编辑必须严格保持 JSON 合法并重启生效。
执行步骤
- 先在服务端开启 allow-list,让玩家尝试进入一次,在日志或 allowlist.json 中取得其准确 XUID,再手工补充条目。
- permissions.json 中按需要设置 operator、member、visitor 等级,管理员只授予必要的人,并记录每次授权时间与原因。
- 编辑 JSON 后先用校验工具或在线 JSON 解析确认语法正确,再重启服务端,避免格式错误导致整份权限文件被忽略。
- 建立一份权限台账,记录谁有 op、谁在白名单、谁被移除,避免靠记忆管理导致误删或越权。
验收标准
- 未在白名单的账号无法进入,白名单内的账号可以正常进入。
- 管理员能执行需要的命令,普通玩家无法执行管理命令。
- 重启服务端后权限配置仍然生效,日志中没有 JSON 解析错误。
常见误区
- 直接复制别人的 XUID 或填错一位数字,白名单形同虚设。
- 把所有人设成 operator,出事后无法追责也难以收回权限。
建议先在测试服或测试存档验证,再切换到正式服;涉及升级、迁移和网络调整时先保留可回退副本。