/test

/test

原文：Commands/test；源修订：3724366。

本命令不同于 /test（基岩版）。Java 版独有；权限等级为 2。管理和执行 GameTest。

语法

语法 作用
test (clearall [<radius>]|clearthat|clearthese) 清除与测试关联的结构和方块。
test create <id> [<width>] [<height> <depth>] 创建测试。
test locate <tests> 定位已加载区块中的测试。
test pos [<var>] 显示测试中准星所指方块的局部坐标。
test (resetclosest|resetthat|resetthese) 重置测试结构。
test run <tests> [<numberOfTimes>] [<untilFailed>] [<rotationSteps>] [<testsPerRow>] 运行一个或多个测试。
test (runclosest|runthat|runthese) [<numberOfTimes>] [<untilFailed>] 运行一个或多个测试。
test runmultiple <tests> [<amount>] 运行一个或多个测试。
test runfailed [<numberOfTimes>] [<untilFailed>] [<rotationSteps>] [<testsPerRow>] 运行失败的测试。
test runfailed [<onlyRequiredTests>] [<numberOfTimes>] 运行失败的测试。
test stop 停止所有测试。
test verify <tests> 验证测试。
test (export <test>|exportclosest|exportthat|exportthese) 导出测试；仅在 IDE 环境中可用。

参数

clearall：清除指定半径内的所有测试。

resetclosest、runclosest、exportclosest：重置、运行或导出半径 15 内最近的测试。

clearthat、resetthat、runthat、exportthat：清除、重置、运行或导出准星指向的测试。

clearthese、resetthese、runthese、exportthese：清除、重置、运行或导出半径 200 内的全部测试。

参数 类型 说明与默认值
radius integer 要清除测试的半径；默认 200。
id resource_location 测试 ID。
width integer 测试结构宽度；默认 5。
height integer 测试结构高度；默认为 <width> 的值。
depth integer 测试结构深度；默认为 <width> 的值。
var string 复制的代码片段中要使用的变量名称；默认 pos。
tests resource_selector 测试 ID。
numberOfTimes integer 在不同批次中重复每项测试的次数；默认 1。
untilFailed bool 是否在一次迭代失败后立即停止测试；默认 false。
rotationSteps integer 对测试施加的额外 90 度旋转步数；默认 0。
testsPerRow integer 网格布局中每行的测试数量；默认 8。
amount integer 同一批次中重复每项测试的次数；默认 1。
onlyRequiredTests bool 是否只运行必要测试；默认 false。
test resource 测试 ID。

参数类型规则见参数类型。

结果

命令不完整或任意参数指定不正确时无法解析。测试不存在时失败；test create 中的 <width>、<height> 或 <depth> 大于 48 时失败。其他情况成功。

输出

失败时成功次数、success、result 均为 0。成功时成功次数与 success 均为 1。清除或重置测试的命令，其 result 为被清除或重置的测试结构数；其他成功命令的 result 为 1。

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