方块特性

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

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

应用特性

方块特性可轻松为自定义方块应用原版方块状态（如朝向），无需借助复杂的事件和触发器系统。

::: code-group

{
  "format_version": "1.20.30",
  "minecraft:block": {
    "description": {
      "identifier": "wiki:custom_slab",
      "menu_category": {
        "category": "construction",
        "group": "itemGroup.name.slab"
      },
      "traits": {
        "minecraft:placement_position": {
          "enabled_states": ["minecraft:vertical_half"]
        }
      }
    },
    "components": { ... },
    "permutations": [ ... ]
  }
}

:::

此示例将在放置时设置minecraft:vertical_half方块状态为'top'或'bottom'——具体取决于玩家视角位置。

仍需通过置换系统配合条件查询来实现功能差异：

q.block_state('minecraft:vertical_half') // 查询垂直半区状态

放置朝向

记录玩家放置方块时的旋转方向信息。

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

可启用以下状态：

状态名称	可选值	描述
`minecraft:cardinal_direction`	`"south"`（默认） `"north"` `"west"` `"east"`	放置时玩家的主要朝向（东南西北）
`minecraft:facing_direction`	`"down"`（默认） `"up"` `"south"` `"north"` `"west"` `"east"`	放置时玩家的完整朝向（含上下方向）

额外参数：

y_rotation_offset - 此旋转偏移仅适用于水平方向状态值（北/南/西/东），必须指定轴对齐角度（如90、180、-90）

::: code-group

"minecraft:placement_direction": {
  "enabled_states": ["minecraft:cardinal_direction"],
  "y_rotation_offset": 180 // Y轴旋转偏移量
}

:::

放置位置

记录玩家放置方块时的具体位置信息。

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

可启用以下状态：

状态名称	可选值	描述
`minecraft:block_face`	`"down"`（默认） `"up"` `"south"` `"north"` `"west"` `"east"`	方块被放置时所处的表面方位
`minecraft:vertical_half`	`"top"` `"bottom"`（默认）	方块被放置时所处的垂直半区位置

此特性无额外参数

::: code-group

"minecraft:placement_position": {
  "enabled_states": [
    "minecraft:block_face",    // 方块表面方位
    "minecraft:vertical_half"   // 垂直半区位置
  ]
}

:::

3.7 KiB Raw Blame History Unescape Escape

方块特性

应用特性

放置朝向

放置位置

3.7 KiB

Raw Blame History