概览
minecraft:geometry 是一个方块组件:写在自定义方块的 components 对象中。 选择绘制方块的 3D 模型。你可以只填模型名称,也可以填一个带有隐藏骨骼或剔除等额外选项的对象。内置形状有 "minecraft:geometry.full_block" 和 "minecraft:geometry.cross"。
字段
| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
identifier | string | 无 | 模型名称,来自资源包中的 .geo.json 或某个内置形状。 |
culling | string | "" | 方块剔除文件的名称,用于隐藏被相邻方块遮住的面。 |
culling_shape | string | "" | 用于隐藏相邻方块面的形状。需要开启 VoxelShape 实验性玩法并设置剔除规则。 |
culling_layer | string | 无 | 分组名称,让剔除规则把多个方块视为同一种,例如 "minecraft:culling_layer.leaves"。 |
bone_visibility | object | 无 | 显示或隐藏模型骨骼,使用 true/false 或基于方块状态的 Molang 判断。一个模型做出多种外观时很方便。 |
uv_lock | boolean | string[] | false | 方块旋转时保持纹理不跟着转。设为 true 作用于所有骨骼,或列出骨骼名称。 |
n_way_visual_rotation | NWayVisualRotation | 无 | 把 x、y、z 旋转与方块状态关联,让模型在视觉上旋转,而方块本身保持不变。 |
示例
写在 BP/blocks/<name>.json 的 components 对象中(值为默认值或占位值):
BP/blocks/<name>.json
{
"minecraft:geometry": {
"identifier": "",
"culling": "",
"culling_shape": "",
"culling_layer": "",
"bone_visibility": {},
"uv_lock": false,
"n_way_visual_rotation": {}
}
}