Block Traits
应用特性
方块特性可用于轻松为自定义方块应用原版方块状态（如朝向），无需使用事件和触发器。
BP/blocks/custom_slab.json
json
{
"format_version": "1.21.70",
"minecraft:block": {
"description": {
"identifier": "wiki:custom_slab",
"menu_category": {
"category": "construction",
"group": "minecraft:itemGroup.name.slab"
},
"traits": {
"minecraft:placement_position": {
"enabled_states": ["minecraft:vertical_half"]
}
}
},
"components": { ... },
"permutations": [ ... ]
}
}此示例将在放置时根据玩家视角位置，将minecraft:vertical_half方块状态设置为'top'或'bottom'。
要使该状态产生实际效果，仍需通过条件查询创建变体：
c
q.block_state('minecraft:vertical_half')特性列表
放置朝向
包含玩家放置方块时的旋转信息。
从实验性玩法Upcoming Creator Features中发布，适用于1.20.20及以上格式版本。
提供的状态
| 状态 | 取值 | 描述 |
|---|---|---|
minecraft:cardinal_direction | "south" (默认)"north""west""east" | 玩家放置时的基本朝向（东南西北）。 |
minecraft:facing_direction | "down" (默认)"up""south""north""west""east" | 玩家放置时的完整朝向（含上下方向）。 |
附加参数
y_rotation_offset- 此旋转偏移量仅适用于水平方向状态值（北/南/东/西）。只能指定轴对齐角度（如90、180、-90）。
minecraft:block > description > traits
json
"minecraft:placement_direction": {
"enabled_states": ["minecraft:cardinal_direction"],
"y_rotation_offset": 180
}放置位置
包含玩家放置方块的位置信息。
从实验性玩法Upcoming Creator Features中发布，适用于1.20.20及以上格式版本。
提供的状态
| 状态 | 取值 | 描述 |
|---|---|---|
minecraft:block_face | "down" (默认)"up""south""north""west""east" | 方块被放置时所依附的方块面。 |
minecraft:vertical_half | "top""bottom" (默认) | 方块被放置时的垂直位置（上半/下半）。 |
minecraft:block > description > traits
json
"minecraft:placement_position": {
"enabled_states": [
"minecraft:block_face",
"minecraft:vertical_half"
]
}贡献者
本页面上的文本和图像内容根据 知识共享署名 4.0 国际许可协议
本页中的代码示例根据 MIT 许可证