/worldborder

原文：Commands/worldborder；源修订：3834928。

本命令为 Java 版独有，所需权限等级为 2。用于控制世界边界，只影响命令执行所在维度的边界。不要与 /immutableworld 混淆。

语法

worldborder add <distance> [<time>]
worldborder center <pos>
worldborder damage amount <damagePerBlock>
worldborder damage buffer <distance>
worldborder get
worldborder set <distance> [<time>]
worldborder warning distance <distance>
worldborder warning time <time>

以下时间单位按源修订正文描述保留。

• add：增大或缩小世界边界。可指定 time，让边界在该秒数内从原大小变为新大小；省略时立即改变。即使游戏暂停，边界仍继续变化并显示动画。初始大小为 59999968 格。
• center：将边界中心移至指定坐标，初始中心为 (0,0)。
• damage amount：设置伤害量。位于边界缓冲区以外的玩家，每超出缓冲区一格，每秒受到该数值的伤害；初始值为每格每秒 0.2 点。
• damage buffer：设置缓冲距离。玩家超出世界边界这一距离后才开始受伤，初始值为 5 格。
• get：获取当前世界边界大小。
• set：设置正方形世界边界区域的宽和长，单位为格。可指定 time，让边界在该秒数内从原大小变为新大小；省略时立即改变。即使游戏暂停仍继续变化并显示动画。初始大小为 59999968 格。
• warning distance：设置警告距离。玩家与边界的距离小于指定格数时，屏幕染红；初始值为 5 格。使用快速画质时不显示该染色。
• warning time：设置警告时间。收缩中的边界预计在指定秒数内到达玩家时，屏幕染红；初始值为 15 秒。使用快速画质时不显示该染色。

参数

• distance（add，double）：边界直径增加的格数。须为 -59999968 至 59999968（含端点）的双精度浮点数。
• time（add、set，integer）：边界从当前直径变为新直径所用的秒数，省略时为 0。须为不小于 0 的 32 位整数。
• pos（vec2）：边界中心的水平坐标。须为两个由空格分隔的坐标，可使用波浪号表示相对于执行位置的坐标；X、Z 均须在 -29999984 至 29999984 内（含端点）。
• damagePerBlock（float）：玩家每超出边界缓冲区一格、每秒受到的伤害。须为不小于 0.0 的单精度浮点数，初始为 0.2。例如设为 0.1，玩家超出缓冲区 5 格时每秒受到 0.5 点伤害；不足半颗心的伤害可能不改变生命值显示，但仍会累积。
• distance（damage buffer，float）：玩家在边界外开始受伤前的缓冲距离。须为不小于 0.0 的单精度浮点数，初始为 5.0。
• distance（set，double）：新的世界边界直径。原文参数类型范围为 -59999968 至 59999968（含端点），但实际新尺寸仍须满足结果部分的限制。
• distance（warning distance，integer）：玩家开始看见边界接近警告时与边界的距离。须为不小于 0 的 32 位整数，初始为 5。
• time（warning time，integer）：移动边界经过玩家位置前多久开始显示视觉警告，单位为秒。须为不小于 0 的 32 位整数，初始为 15。

结果

参数指定不正确时无法解析。下列情形失败，其他情况成功：

• add、set：大小未改变，或新大小小于 1.0、大于 59999968。
• center：中心未改变，或指定 X、Z 不在 ±29999984 范围内。
• damage amount：伤害量未改变。
• damage buffer：缓冲距离未改变。
• warning distance：警告距离未改变。
• warning time：警告时间未改变。

输出

失败时成功次数、成功值、结果值均为 0。成功时成功次数和成功值均为 1，结果值如下：

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