方块置换 `permutations`

:::tip 格式要求 & 最低引擎版本 1.20.30 在学习方块变换前，您应当已熟练掌握方块状态知识。

使用方块状态时，请确保资源包清单中的min_engine_version为1.20.20或更高版本。 :::

方块permutations数组提供了一种基于当前置换（状态值集合）条件性应用组件（包括事件触发器和标签）的方式。

permutations数组中的组件可以覆盖方块的基类组件以及其他组件列表中的组件。置换数组中最后出现的条目具有最高优先级。

可旋转方块 是 方块置换 的一种常用用法。

定义置换

permutations数组是minecraft:block的直接子项，由包含组件的对象组成。当条件判断为真值（非false或0）时，相关组件将被应用。

置换条件必须遵守其限制条件。

自实验性玩法Holiday Creator Features发布，支持格式版本1.19.70及更高。

::: code-group

{
  "format_version": "1.20.30",
  "minecraft:block": {
    "description": {
      "identifier": "wiki:custom_block",
      "states": {
        "wiki:integer_state_example": [2, 4, 6, 8],
        "wiki:boolean_state_example": [false, true],
        "wiki:string_state_example": ["red", "green", "blue"]
      }
    },
    "components": {},
    "permutations": [
      {
        "condition": "q.block_state('wiki:integer_state_example') == 2",
        "components": {
          "minecraft:friction": 0.1
        }
      },
      {
        "condition": "q.block_state('wiki:boolean_state_example')",
        "components": {
          "minecraft:friction": 0.8 // 覆盖之前的置换
        }
      },
      {
        "condition": "q.block_state('wiki:string_state_example') == 'red' && !q.block_state('wiki:boolean_state_example')",
        "components": {
          "minecraft:geometry": "geometry.pig"
        }
      }
    ]
  }
}

:::

置换条件限制

当条件评估为真值（非false或0）时，关联的组件列表将被应用。

置换条件需以Molang表达式字符串形式编写，并具有严格限制：

条件判断完全基于方块的置换状态，因此只能使用q.block_state查询函数
这意味着条件判断不会产生副作用
- 禁止使用以下数学函数：math.die_roll、math.die_roll_integer、math.random、math.random_integer
- 不可进行变量赋值操作

（注：保留英文术语如Component、Entity、Block等，根据中文技术文档惯例处理专有名词）

2.8 KiB Raw Blame History Unescape Escape

方块置换 permutations

定义置换

置换条件限制

2.8 KiB

Raw Blame History

方块置换 `permutations`