命令/tickingarea

此特性为基岩版和教育版独有。

tickingarea

需要的权限等级	1
限制条件	启用作弊

添加、删除或列出常加载区域。同时最多可以定义10个常加载区域。

语法[]

tickingarea add <from: x y z> <to: x y z> [name: string]

tickingarea add <from: x y z> <to: x y z> [name: string] [preload: Boolean]

tickingarea add circle <center: x y z> <radius: int> [name: string]

tickingarea add circle <center: x y z> <radius: int> [name: string] [preload: Boolean]

tickingarea remove <position: x y z>

tickingarea remove <name: string>

tickingarea remove_all

tickingarea preload <name: string> [preload: Boolean]

tickingarea preload <position: x y z> [preload: Boolean]

tickingarea list [all-dimensions: AllDimensions]

以上的背景色是为了方便阅读。

Y坐标在识别区块的时候实际上并不需要，因为区块跨越整个世界的垂直高度。但是必须在下面的参数中显示的地方输入Y坐标，它可以是任意值，但总是被储存为0。

from: x y z与to: x y z

指定用于定义矩形常加载区域的两个对角坐标。

center: x y z

指定用于定义圆形常加载区域的圆心的坐标。

radius: int

指定圆形常加载区域的半径作为从中心到圆周的区块数。它只能是从1到4的整数。

name: string

指定常加载区域的可选名称。包含空格的值必须用英文双引号括起来。该名称会显示在常加载区域列表中，可用于删除特定区域或设置和查询特定区域是否预加载。

position: x y z

指定要选择的常加载区域所包含的坐标。可用于删除特定区域或设置和查询特定区域是否预加载。

preload: Boolean

指定常加载区域是否预加载，只能填写false或true。在add语法中若不填则默认为false，在preload语法中若不填则可以查询指定的常加载区域是否预加载。

all-dimensions: AllDimensions

指定是否列出所有维度中的常加载区域。只能填写all-dimensions，如不填则默认为仅显示本维度常加载区域。

若参数没有被正确指定、尝试添加第11个常加载区域、尝试添加大于100个区块的常加载区域或半径小于1或大于4个区块的圆形常加载区域，或命令失败。

命令	触发条件	基岩版
任意	指定的参数不正确	执行失败
`/tickingarea add ...`	尝试添加第11个常加载区域
	尝试添加大于100个区块的常加载区域或半径小于1或大于4个区块的圆形常加载区域
	尝试添加重复名称的常加载区域时
任意	执行成功时	添加与矩形区域有重叠部分的所有区块组成的常加载区域

成功时：

add - 添加与矩形区域有重叠部分的所有区块组成的常加载区域。
add circle - 添加与圆形区域有重叠部分的所有区块组成的常加载区域。
remove - 删除常加载区域。如果指定了名称，则只会删除具有该名称的常加载区域。如果指定了位置，则删除包含这个坐标点的所有常加载区域。
remove_all - 删除本维度中所有已定义的常加载区域。
preload - 设置或显示常加载区域是否预加载，0表示不会预加载，1表示会预加载。如果指定了名称，则只会处理具有该名称的常加载区域。如果指定了位置，则处理包含这个坐标点的所有常加载区域。
list - 显示当前维度中的常加载区域。如果指定了可选的所有维度参数，则列出已定义的所有常加载区域。注意，列表中显示的坐标在矩形的情况下被调整为区块的边界，在圆的情况下被调整为区块的中心。

基岩版
1.2.0		1.2.0.2			加入了`/tickingarea`。
1.18.30		1.18.20.21			加入了`preload`参数。

语言