/ban 命令
来源：Commands/ban，英文修订 ID：3563909。
此条目描述踢出并封禁玩家的命令；仅踢出玩家的命令见 /kick。本组命令仅适用于 Java 版。
这些命令按玩家游戏档案或 IP 地址，将一名或多名玩家加入服务器的封禁名单（黑名单）。封禁名单列出不允许连接服务器的玩家或 IP 地址，优先级高于白名单。
管理员可使用 /pardon，或手动修改 banned-players.json，从封禁名单中移除玩家。
ban
所需权限等级为 3，仅限专用服务器。
将玩家档案加入服务器黑名单，阻止使用这些档案 UUID 的任何人连接服务器。
语法
ban <targets> [<reason>]
参数
<targets>: game_profile：要加入黑名单的玩家档案，可使用玩家名称、目标选择器或 UUID。
<reason>: message：显示给被封禁玩家、其他管理员并写入服务器日志的消息。默认为 Banned by an operator.。消息可包含空格，消息中的目标选择器会替换为目标名称。
结果与输出
命令不完整或任一参数指定错误时无法解析；目标选择器未解析为一名或多名在线玩家，或没有向黑名单添加任何新档案时失败。其他情况成功。
此命令没有可取得的成功次数。失败时 success 和 result 值为 0；成功时 success 为 1，result 为加入黑名单的新玩家名称数量。
ban-ip
所需权限等级为 3，仅限专用服务器。
把指定 IP 地址，或指定在线玩家的 IP 地址加入服务器黑名单，阻止来自该地址的任何人连接服务器。
语法
ban-ip <target> [<reason>]
参数
targets: string：要加入黑名单的 IP 地址，或代表该玩家 IP 地址的在线玩家名称。必须为不含空格的单个词。此方式不能封禁 IPv6 地址，见 MC-97885。
<reason>: message：显示给被封禁玩家、其他管理员并写入服务器日志的消息。默认为 Banned by an operator.，消息格式同上。
结果与输出
命令不完整或任一参数指定错误时无法解析；targets 既不是有效 IP，也不是在线玩家名称，或没有添加任何新 IP 地址时失败。其他情况成功。
此命令没有可取得的成功次数。失败时 success 和 result 为 0；成功时 success 为 1，result 为使用指定 IP 连接的在线玩家数量。
banlist
所需权限等级为 3，仅限专用服务器。显示服务器黑名单。
语法
banlist [ips|players]
结果与输出
命令不完整时无法解析；其他情况成功。成功时 success 为 1，result 为指定名单中的条目数；没有可取得的成功次数。
banip
此为 Java 版 Classic 中与 /ban-ip 对应的过时命令。按 IP 封禁玩家；不能在游戏内撤销，必须手动修改 banned-ip.txt。
语法
banip (<address>|<name>) [<reason>]
另见
参考资料
本文为 Minecraft Wiki 对应英文条目的中文翻译与改编，已按要求省略变更历史。原作者与贡献者见来源页及其历史；除另有说明外，按 CC BY-NC-SA 3.0 非商业、署名、相同方式共享。