命令/worldborder

/worldborder

需要的权限等级	2
限制条件	无

此命令用于控制世界边界。

语法

worldborder add <distance> [<time>]

将当前的世界边界边长同时加上指定的距离。可指定世界边界从旧边界过渡到新边界所持续的时间，若未指定则世界边界大小的变化会瞬间完成。

worldborder center <pos>

将世界边界的中心设置为水平坐标<pos>处。边界中心的初始值为（0, 0）。

worldborder damage amount <damagePerBlock>

指定世界边界外伤害大小，设置玩家在世界边界缓冲区外超出每方格每秒所受到的伤害量。玩家在世界边界伤害缓冲区外时，每秒受到的伤害为距缓冲区的距离乘<damagePerBlock>。其初始值为0.2。

worldborder damage buffer <distance>

设置玩家越过世界边界后仍不受伤害的安全缓冲距离。玩家在世界边界外时，距离世界边界超过此距离才会受到伤害。边界缓冲区的初始值为5格。

worldborder get

获取世界边界的当前边长。可以使用/execute store储存其值。

worldborder set <distance> [<time>]

设置世界边界的边长大小。可指定世界边界从旧边界过渡到新边界所持续的时间，若未指定则世界边界大小的变化会瞬间完成。

worldborder warning distance <distance>

设置世界边界接近警告的距离。当玩家在边界内与世界边界的距离小于警告距离时，将玩家的屏幕染红作为警告。其初始值为5格。若玩家的图像品质设为“流畅”，则屏幕不会泛红。

worldborder warning time <time>

设置世界边界接近警告的时间。当正在收缩的世界边界预计在指定时间内达到玩家所在位置时，将玩家的屏幕染红作为警告。其初始值为15秒。若玩家的图像品质设为“流畅”，则屏幕不会泛红。

参数

<distance>：double（仅add模式）

指定世界边界边长要增加的方块数。

必须为 双精度浮点数。且必须在-59,999,968和59,999,968之间（含）。

<time>：time（仅add和set模式）

指定世界边界从原边长变化至新边长所需的过渡时间。若未指定，默认为0。

必须为 单精度浮点数，并附有单位。且必须不小于0游戏刻。单位可以是：

• d：一个游戏日，合24000游戏刻，
• s：一秒，合20游戏刻，
• t（默认且可省略）：一个游戏刻，无单位时默认。

时间在单位转化成游戏刻后取最近的整数。例如：.5d等价于12000游戏刻。

<pos>：vec2

指定世界中心的水平坐标。

必须为二维坐标，元素为双精度浮点数。允许波浪号标记。并且其X和Z应在±29999984之间（含）。

<damagePerBlock>：float

指定玩家在越过世界边界外缓冲区后每远离一格每秒受到的伤害。例如，如果<damagePerBlock>是0.1，则处于缓冲区5方格外的玩家每秒会受到0.5点伤害（伤害少于半颗心可能不会改变生命条的视觉效果，但仍会累积）。初始值为0.2。

必须为 单精度浮点数。且必须大于等于0.0。

<distance>：float（仅damage buffer模式）

指定玩家超出后受到伤害前的缓冲区方格数。初始值为5.0。

必须为 单精度浮点数。且必须大于等于0.0。

<distance>：double（仅set模式）

指定新的世界边界的边长。

必须为 双精度浮点数。且必须在-59,999,968和59,999,968之间（含）。

<distance>：integer（仅warning distance模式）

指定在世界边界内向玩家显示边界接近警告时玩家与世界边界的距离。初始值为5。

必须为 32位整数。且必须大于等于0。

<time>：time（仅warning time模式）

当正在收缩的世界边界预计在指定时间内达到玩家所在位置时提前显示警告。初始值为15秒。

必须为 单精度浮点数，并附有单位。且必须不小于0游戏刻。单位可以是：

• d：一个游戏日，合24000游戏刻，
• s：一秒，合20游戏刻，
• t（默认且可省略）：一个游戏刻，无单位时默认。

时间在单位转化成游戏刻后取最近的整数。例如：.5d等价于12000游戏刻。

结果

命令	触发条件	Java版
任意	命令不完整或参数未正确指定	无法解析
/worldborder add ... /worldborder set ...	大小未改变	执行失败
	指定的世界边界大小小于1.0或大于59,999,968格
/worldborder center ...	世界边界中心未改变
	指定的中心水平坐标的X和Z值超过了±29999984
/worldborder damage amount ...	伤害量未改变
/worldborder damage buffer ...	缓冲区距离未改变
/worldborder warning distance ...	警告距离未改变
/worldborder warning time ...	警告时间未改变
任意	不符合以上所有条件	执行成功

输出

命令	版本	条件	成功次数	/execute store success ...	/execute store result ...
任意	Java版	执行失败	0	0	0
/worldborder add ...		执行成功	1	1	指定的<distance>
/worldborder center ...		执行成功	1	1	0
/worldborder damage amount ...		执行成功	1	1	指定的<damagePerBlock>
/worldborder damage buffer ...		执行成功	1	1	指定的<distance>
/worldborder get		执行成功	1	1	世界边界的大小，四舍五入至最近的整数
/worldborder set ...		执行成功	1	1	世界边界大小的变化量 （正数为增加，负数为减少）
/worldborder warning distance ...		执行成功	1	1	指定的<distance>
/worldborder warning time ...		执行成功	1	1	指定的<time>

示例

• 将警告距离设定为10的9次方（若图像品质允许渲染屏幕红色效果，则在默认边界宽度下，玩家屏幕将一直带有红色警告效果）：

worldborder warning distance 1000000000

• 以最近一位玩家脚部坐标为执行位置，设定世界边界中心，并改变世界边界宽度为16：

execute as @p at @s run worldborder center ~ ~
worldborder set 16

历史

Java版
1.8			14w17a				加入了/worldborder。
			14w19a				加入了/worldborder damage和/worldborder warning。
			14w26a				加入了/worldborder add。
			14w29a				加入了/worldborder get。
1.17			21w17a				世界边界边长参数现在使用双精度浮点型而不是单精度浮点型。
							允许的最大边长从60,000,000变为59,999,968。
1.18			pre2				中心的X和Z值现在必须在±29,999,984之间（含）。
1.21.9			25w36a				现在/worldborder只控制执行维度的世界边界，此前控制所有维度的世界边界。
1.21.11			25w43a				现在/worldborder add和/worldborder set以刻为单位，而不再是秒。
							将/worldborder add和/worldborder set的时间参数名称由time改为ticks。
			25w44a				/worldborder add、/worldborder set和/worldborder warning的时间参数类型现在是time。
							将/worldborder add和/worldborder set的时间参数名称由ticks改为time。