/whitelist

原文：Commands/whitelist；源修订：3778184。

仅适用于服务器。权限等级：Java 版为 3，基岩版为 4；基岩版需要开启作弊，并以 /allowlist 为别名。

用于管理服务器白名单。

Java 版中，启用白名单后，服务器操作员始终可以连接，即使其档案不在白名单中。基岩版中，无论是否为操作员，玩家都必须在白名单中。获准玩家的档案存储于 whitelist.json，基岩版则存储于 allowlist.json 配置文件。

语法

语法	作用
Java 版 `whitelist add <targets>`；基岩版 `allowlist add <name: string>`	将玩家档案加入白名单；玩家不必在线。
`whitelist list`	显示白名单中的全部玩家档案。
`whitelist off`	禁用服务器白名单；基岩版未实现。
`whitelist on`	启用服务器白名单；基岩版未实现。
`whitelist reload`	从磁盘重新加载 `whitelist.json` 或基岩版的 `allowlist.json`；用于在游戏外修改文件后。
Java 版 `whitelist remove <targets>`；基岩版 `allowlist remove <name: string>`	从白名单移除玩家档案；玩家不必在线。

Java 版的 targets（game_profile）：指定要加入或移出白名单的玩家档案。

基岩版的 name: string（basic_string）：指定要加入或移出白名单的玩家名称。

以下为 Java 版结果。命令不完整或参数指定不正确时无法解析。以下情况失败：白名单已启用时执行 on；白名单已禁用时执行 off；目标选择器未解析为一个或多个在线玩家；add 没有新加入任何玩家档案；remove 指定的所有档案都不在白名单中。其他情况成功。

Java 版成功次数均不适用。失败时 success 和 result 均为 0；成功时 success 为 1，result 如下：

此功能为基岩版编辑器独有，仅适用于服务器，需要开启作弊；权限等级为 4。用于重新加载编辑器白名单。

editor-allowlist reload

源页面对子命令作用的详细说明标记为未知。

命令不完整时无法解析；其他情况成功。

来源为 Minecraft Wiki；本中文翻译/改编按 CC BY-NC-SA 3.0 共享。