xiaokun/netease-modsdk-wiki
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

完整版BedrockWiki镜像！

Browse Source
This commit is contained in:
boybook
2025-03-20 11:52:46 +08:00
parent 1994c41f01
commit bf9aa4b056
214 changed files with 9042 additions and 8867 deletions
Download Patch File Download Diff File Expand all files Collapse all files

403
docs/wiki/blocks/rotatable-blocks.md Normal file
View File

@@ -0,0 +1,403 @@
---
title: 可旋转方块
category: 巧思案例
mentions:
- Ultr4Anubis
- SmokeyStack
- ihategravel2
- MedicalJewel105
- MajestikButter
- QuazChick
---
# 可旋转方块
<!--@include: @/wiki/bedrock-wiki-mirror.md-->
::: tip 格式与最低引擎版本 `1.20.30`
本教程假设您已掌握方块基础知识，包括[方块状态](/wiki/blocks/block-states)与[方块特性](/wiki/blocks/block-traits)。
开始前请先阅读[方块指南](/wiki/blocks/blocks-intro)。
:::
## 旋转类型
- ### [基本方向旋转](#cardinal-direction-rotation)
- 适用于雕刻南瓜和熔炉
- 4个方向 - 'north'（北）、'south'（南）、'east'（东）、'west'（西）
- ### [面向方向旋转](#facing-direction-rotation)
- 适用于发射器和观测器
- 6个方向 - 'down'（下）、'up'（上）、'north'（北）、'south'（南）、'east'（东）、'west'（西）
- ### [方块面附着旋转](#block-face-rotation)
- 适用于梯子和物品展示框
- 6个附着方向 - 'down'（下）、'up'（上）、'north'（北）、'south'（南）、'east'（东）、'west'（西）
- ### [原木/柱体旋转](#log-rotation)
- 适用于原木和玄武岩
- 3个轴对齐方向
- ### [精确旋转](/wiki/blocks/precise-rotation)
- 适用于头颅、告示牌和旗帜
- 16个方向（以22.5度递增）
- 4个侧面附着方向
## 基本方向旋转
### 特性
使用`minecraft:placement_direction`方块特性并启用`minecraft:cardinal_direction`状态来设置方块方向。
::: code-group
```json [minecraft:block]
"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`状态并应用相应旋转。
**下方旋转值假设模型正面朝北**
::: code-group
```json [minecraft:block]
"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:placement_direction`方块特性并启用`minecraft:facing_direction`状态来设置方块方向。
::: code-group
```json [minecraft:block]
"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`状态并应用相应旋转。
**下方旋转值假设模型正面朝北**
::: code-group
```json [minecraft:block]
"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:placement_position`方块特性并启用`minecraft:block_face`状态来设置方块附着面。
::: code-group
```json [minecraft:block]
"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`状态并应用相应旋转。
**下方旋转值假设模型正面朝北**
::: code-group
```json [minecraft:block]
"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] }
}
}
]
```
:::
## 原木旋转
实现与原版原木相同的旋转方式
::: warning 实验性功能
需要启用`假日创作者功能`来触发事件
:::
### 方块状态
::: code-group
```json [minecraft:block > description]
"states": {
"wiki:axis": [0, 1, 2]
}
```
:::
### 方块事件与触发
使用Molang表达式通过查询方块附着面来确定坐标轴方向（转换为0、1或2）
::: code-group
```json [minecraft:block > events]
"wiki:set_axis": {
"set_block_state": {
"wiki:axis": "数学运算.floor(q.block_face / 2)"
}
}
```
:::
使用`minecraft:on_player_placing`触发器组件调用事件
::: code-group
```json [minecraft:block > components]
"minecraft:on_player_placing": {
"event": "wiki:set_axis"
}
```
:::
### 置换
::: code-group
```json [minecraft:block]
"permutations": [
{
"condition": "q.block_state('wiki:axis') == 0",
"components": {
"minecraft:transformation": { "rotation": [0, 0, 0] }
}
},
{
"condition": "q.block_state('wiki:axis') == 1",
"components": {
"minecraft:transformation": { "rotation": [90, 0, 0] }
}
},
{
"condition": "q.block_state('wiki:axis') == 2",
"components": {
"minecraft:transformation": { "rotation": [0, 0, 90] }
}
}
]
```
:::
### 原木旋转示例
::: warning 实验性功能
本示例需要启用`假日创作者功能`以使用`minecraft:unit_cube`
:::
<Spoiler title="基础自定义原木JSON">
::: code-group
```json [BP/blocks/custom_log.json]
{
"format_version": "1.20.30",
"minecraft:block": {
"description": {
"identifier": "wiki:custom_log",
"states": {
"wiki:axis": [0, 1, 2]
}
},
"components": {
"minecraft:destructible_by_mining": {
"seconds_to_destroy": 1.5
},
"minecraft:destructible_by_explosion": {
"explosion_resistance": 15
},
"minecraft:material_instances": {
"*": {
"texture": "log_side"
},
"end": {
"texture": "log_top"
},
"up": "end",
"down": "end"
},
"minecraft:unit_cube": {},
"minecraft:on_player_placing": {
"event": "wiki:set_axis"
}
},
"events": {
"wiki:set_axis": {
"set_block_state": {
"wiki:axis": "Math.floor(q.block_face / 2)"
}
}
},
"permutations": [
{
"condition": "q.block_state('wiki:axis') == 0",
"components": {
"minecraft:transformation": { "rotation": [0, 0, 0] }
}
},
{
"condition": "q.block_state('wiki:axis') == 1",
"components": {
"minecraft:transformation": { "rotation": [90, 0, 0] }
}
},
{
"condition": "q.block_state('wiki:axis') == 2",
"components": {
"minecraft:transformation": { "rotation": [0, 0, 90] }
}
}
]
}
}
```
:::
</Spoiler>