Bedrock Wiki
新手入门指南
JSON UI
Meta
NBT
世界生成
动画控制器
命令
实体
战利品、配方与交易
文档
方块
服务器
概念
物品
视觉效果
粒子效果
脚本编写
虚拟现实

可旋转方块

可旋转方块

格式与最低引擎版本 1.21.70

本教程假设您已掌握方块基础知识，包括方块状态和方块特性。 开始前请先阅读方块指南。

旋转类型 ​

  • 基本方向旋转 ​

    • 适用于雕刻南瓜和熔炉等方块
    • 4种朝向 - 'north'（北）、'south'（南）、'east'（东）和'west'（西）

  • 朝向旋转 ​

    • 适用于发射器和侦测器等方块
    • 6种朝向 - 'down'（下）、'up'（上）、'north'（北）、'south'（南）、'east'（东）和'west'（西）

  • 方块面附着旋转 ​

    • 适用于梯子和物品展示框等方块
    • 6种附着面 - 'down'（下）、'up'（上）、'north'（北）、'south'（南）、'east'（东）和'west'（西）

  • 原木/立柱旋转 ​

    • 适用于原木和玄武岩等方块
    • 3种轴向旋转

  • 精确旋转 ​

    • 适用于头颅、告示牌和旗帜
    • 16种方向（22.5度的倍数）
    • 4种基本侧面附着方向

基本方向旋转 ​

特性配置 ​

通过启用minecraft:cardinal_direction状态，使用minecraft:placement_direction方块特性来设定方块的朝向。

minecraft:block
json
"description": {
  "identifier": "wiki:cardinal_direction_example",
  // 在此定义方块特性
  "traits": {
    "minecraft:placement_direction": {
      "enabled_states": ["minecraft:cardinal_direction"], // 可用于查询，例如`q.block_state('minecraft:cardinal_direction') == 'north'`
      "y_rotation_offset": 180 // 朝向玩家
    }
  }
}

状态变换 ​

利用方块状态变换实现旋转。每个变换包含minecraft:transformation组件，通过检查minecraft:cardinal_direction状态并应用相应旋转。

以下旋转值假设模型正面朝北。

minecraft:block
json
"permutations": [
  // 朝北
  {
    "condition": "q.block_state('minecraft:cardinal_direction') == 'north'",
    "components": {
      "minecraft:transformation": { "rotation": [0, 0, 0] }
    }
  },
  // 朝西
  {
    "condition": "q.block_state('minecraft:cardinal_direction') == 'west'",
    "components": {
      "minecraft:transformation": { "rotation": [0, 90, 0] }
    }
  },
  // 朝南
  {
    "condition": "q.block_state('minecraft:cardinal_direction') == 'south'",
    "components": {
      "minecraft:transformation": { "rotation": [0, 180, 0] }
    }
  },
  // 朝东
  {
    "condition": "q.block_state('minecraft:cardinal_direction') == 'east'",
    "components": {
      "minecraft:transformation": { "rotation": [0, -90, 0] }
    }
  }
]

朝向旋转 ​

特性配置 ​

通过启用minecraft:facing_direction状态，使用minecraft:placement_direction方块特性来设定方块的朝向。

minecraft:block
json
"description": {
  "identifier": "wiki:facing_direction_example",
  // 在此定义方块特性
  "traits": {
    "minecraft:placement_direction": {
      "enabled_states": ["minecraft:facing_direction"], // 可用于查询，例如`q.block_state('minecraft:facing_direction') == 'north'`
    }
  }
}

状态变换 ​

利用方块状态变换实现旋转。每个变换包含minecraft:transformation组件，通过检查minecraft:facing_direction状态并应用相应旋转。

以下旋转值假设模型正面朝北。

minecraft:block
json
"permutations": [
  // 朝下
  {
    "condition": "q.block_state('minecraft:facing_direction') == 'down'",
    "components": {
      "minecraft:transformation": { "rotation": [-90, 0, 0] }
    }
  },
  // 朝上
  {
    "condition": "q.block_state('minecraft:facing_direction') == 'up'",
    "components": {
      "minecraft:transformation": { "rotation": [90, 0, 0] }
    }
  },
  // 朝北
  {
    "condition": "q.block_state('minecraft:facing_direction') == 'north'",
    "components": {
      "minecraft:transformation": { "rotation": [0, 0, 0] }
    }
  },
  // 朝西
  {
    "condition": "q.block_state('minecraft:facing_direction') == 'west'",
    "components": {
      "minecraft:transformation": { "rotation": [0, 90, 0] }
    }
  },
  // 朝南
  {
    "condition": "q.block_state('minecraft:facing_direction') == 'south'",
    "components": {
      "minecraft:transformation": { "rotation": [0, 180, 0] }
    }
  },
  // 朝东
  {
    "condition": "q.block_state('minecraft:facing_direction') == 'east'",
    "components": {
      "minecraft:transformation": { "rotation": [0, -90, 0] }
    }
  }
]

方块面附着旋转 ​

特性配置 ​

通过启用minecraft:block_face状态，使用minecraft:placement_position方块特性来设定方块的附着面。

minecraft:block
json
"description": {
  "identifier": "wiki:facing_direction_example",
  // 在此定义方块特性
  "traits": {
    "minecraft:placement_position": {
      "enabled_states": ["minecraft:block_face"], // 可用于查询，例如`q.block_state('minecraft:block_face') == 'north'`
    }
  }
}

状态变换 ​

利用方块状态变换实现旋转。每个变换包含minecraft:transformation组件，通过检查minecraft:block_face状态并应用相应旋转。

以下旋转值假设模型正面朝北。

minecraft:block
json
"permutations": [
  // 朝下
  {
    "condition": "q.block_state('minecraft:block_face') == 'down'",
    "components": {
      "minecraft:transformation": { "rotation": [-90, 0, 0] }
    }
  },
  // 朝上
  {
    "condition": "q.block_state('minecraft:block_face') == 'up'",
    "components": {
      "minecraft:transformation": { "rotation": [90, 0, 0] }
    }
  },
  // 朝北
  {
    "condition": "q.block_state('minecraft:block_face') == 'north'",
    "components": {
      "minecraft:transformation": { "rotation": [0, 0, 0] }
    }
  },
  // 朝西
  {
    "condition": "q.block_state('minecraft:block_face') == 'west'",
    "components": {
      "minecraft:transformation": { "rotation": [0, 90, 0] }
    }
  },
  // 朝南
  {
    "condition": "q.block_state('minecraft:block_face') == 'south'",
    "components": {
      "minecraft:transformation": { "rotation": [0, 180, 0] }
    }
  },
  // 朝东
  {
    "condition": "q.block_state('minecraft:block_face') == 'east'",
    "components": {
      "minecraft:transformation": { "rotation": [0, -90, 0] }
    }
  }
]

原木旋转 ​

实现与原版原木相同的旋转方式。

特性配置 ​

通过启用minecraft:block_face状态，使用minecraft:placement_position方块特性来设定方块的附着面。

由于原木旋转不需要使用全部状态值，部分变换配置会相同。

minecraft:block
json
"description": {
  "identifier": "wiki:log_rotation_example",
  // 在此定义方块特性
  "traits": {
    "minecraft:placement_position": {
      "enabled_states": ["minecraft:block_face"], // 可用于查询，例如`q.block_state('minecraft:block_face') == 'north'`
    }
  }
}

状态变换 ​

利用方块状态变换实现旋转。每个变换包含minecraft:transformation组件，通过检查minecraft:block_face状态并应用相应旋转。

minecraft:block
json
"permutations": [
  // X轴旋转
  {
    "condition": "q.block_state('minecraft:block_face') == 'west' || q.block_state('minecraft:block_face') == 'east'",
    "components": {
      "minecraft:transformation": { "rotation": [0, 0, 90] }
    }
  },
  // Y轴旋转
  {
    "condition": "q.block_state('minecraft:block_face') == 'down' || q.block_state('minecraft:block_face') == 'up'",
    "components": {
      "minecraft:transformation": { "rotation": [0, 0, 0] }
    }
  },
  // Z轴旋转
  {
    "condition": "q.block_state('minecraft:block_face') == 'north' || q.block_state('minecraft:block_face') == 'south'",
    "components": {
      "minecraft:transformation": { "rotation": [90, 0, 0] }
    }
  }
]

贡献者

编辑 可旋转方块

本页面上的文本和图像内容根据 知识共享署名 4.0 国际许可协议

本页中的代码示例根据 MIT 许可证