/compute 命令

/compute 命令

来源：Commands/compute，英文修订 ID：3851840。

所需权限等级为 2。原文仍在编写中。

在不同的战利品上下文中计算数值提供器。

语法

compute <CONTEXT> float <floatProvider> [<scale>]
compute <CONTEXT> integer <intProvider>

其中 CONTEXT 为以下形式之一：

  • default：使用 minecraft:command_compute_default 上下文，提供执行位置和 this 实体等通用参数。
  • block <pos>：使用 minecraft:command_compute_position 上下文，除通用参数外，还提供 <pos> 处的方块状态和方块实体。
  • entity <target>：使用 minecraft:command_compute_entity 上下文，除通用参数外，还将选中实体作为 target_entity 提供。

浮点提供器得到浮点值，但命令 result 只能是整数，因此返回前会向下取整。指定 <scale> 时，先乘倍率再向下取整，以返回更高精度。整数提供器已产生整数，因此不需要倍率。

要无损存储浮点值，应使用 /data modify ... compute ...，避免让数值经过 result。

参数

  • <pos>: block_pos：要提供方块状态与方块实体数据的方块坐标。可用绝对、波浪号或插入符相对坐标。
  • <target>: entity：以 target_entity 提供数据的单个实体。可用玩家名称、单实体目标选择器或 UUID。
  • <floatProvider>: context_float_provider：要计算的上下文浮点提供器，可以是标识符或内联定义。
  • <intProvider>: context_int_provider：要计算的上下文整数提供器，可以是标识符或内联定义。
  • <scale>: float：浮点提供器结果的倍率，默认为 1.0。缩放后向下取整，必须为浮点数。

结果

命令不完整或任一参数指定错误时无法解析。无法在指定上下文中计算提供器时失败；成功计算时成功。

输出

失败时成功次数和 success 为 0。成功时二者为 1；浮点模式的 result 为计算后缩放并向下取整的值，整数模式为计算结果。

提供器拥有已注册标识符时，成功的命令还会显示标识符和计算结果。在浮点模式中，若缩放与取整更改了原值，输出也会显示原始浮点值。

本文为 Minecraft Wiki 对应英文条目的中文翻译与改编，已按要求省略变更历史。原作者与贡献者见来源页及其历史；除另有说明外，按 CC BY-NC-SA 3.0 非商业、署名、相同方式共享。