BLOCKS DOCUMENTATION
Version: 1.18.10.4

索引

方块
方块组件
方块定义属性
方块描述属性
方块事件响应
方块触发器组件
返回顶部

方块

方块组件

名称 类型 默认值 描述
minecraft:aim_collision 布尔值 true 如果被设置为false，它可以禁用该方块与实体的碰撞
需要实验性开关：假日创作者功能
名称 类型 默认值 描述
origin 数组 [-8.0, 0.0, -8.0] 碰撞箱的最小位置边界，Origin 不能小于 （-8， 0， -8），也不能大于 （8， 16， 8）。
size 数组 [16.0, 16.0, 16.0] 该组件的箱体的每一侧的大小，当添加到 origin 时，它不能使 origin 小于 （-8， 0， -8） 或大于 （0， 16， 8）。
minecraft:block_collision 布尔值 / JSON 对象 描述方块与实体和活动对象的碰撞。如果设置为 false，则禁用方块与实体的碰撞。大小为 [16， 16， 16] 的原点 [-8.0， 0.0， -8.0] 是一个单位立方体。
需要实验性开关：假日创作者功能
名称 类型 默认值 描述
origin 数组 [-8.0, 0.0, -8.0] 碰撞箱的最小位置边界
size 数组 [16.0, 16.0, 16.0] 该组件的箱体的每一侧的大小
minecraft:block_light_emission 小数 0.0 该方块将会发射的光线数量，在范围[0.0, 1.0]内取值。
minecraft:block_light_filter 整数 0 该方块将会过滤的光线数量。越大的值意味着会有越多的光线被过滤掉（0 - 15）。
minecraft:breakonpush 布尔值 当被活塞推动的时候，该方块会被破坏。
minecraft:breathability 枚举器 solid 此方块的呼吸类型，当生物的呼吸点位于此方块内时，会影响生物的呼吸状态。可用值：solid、air
需要实验性开关：假日创作者功能
minecraft:crafting_table JSON 对象 描述自定义工作台的组件。此组件仅支持 “recipe_shaped” 和 “recipe_shapeless” 类型的配方，不支持 “recipe_furnace” 或 “recipe_brewing_mix” 等其他方法。如果一个项目有两个配方，则配方书将选择第一个被解析的配方。如果两个输入配方相同，则合成可能会assert（断言），并且生成的物品可能会有所不同。
需要实验性开关：假日创作者功能

crafting_tags

定义配方应定义在此表上制作的标签。
返回顶部

custom_description

定义此表的 UI 中的名称。如果未指定，则将使用方块的名称。
返回顶部
minecraft:creative_category 字符串 指定该方块的创造分组。
minecraft:destroy_time 小数 0.0 为该方块设置破坏时间属性。数字越大意味着挖掘时间越长。时间通过基装备以时间为单位测量。
minecraft:display_name 字符串 指定能够映射到当你的鼠标指针悬停在该方块上时将会显示的文本的语言文件键名。
需要实验性开关：假日创作者功能
minecraft:explosion_resistance 小数 0.0 为该方块设置爆炸抗性。
minecraft:flammable JSON 对象 为该方块描述可燃性属性。
名称 类型 默认值 描述
burn_odds 整数 0 当着火时，该方块将会被火焰摧毁的可能性有多大。值必须大于或等于0。
flame_odds 整数 0 当邻近一个火源时，该方块将会着火的可能性有多大。值必须大于或等于0。
minecraft:friction 小数 0.6 为该方块描述摩擦的属性，在一个[0.1, 1.0]的范围内取值。当一个实体在该方块上行进时，摩擦将影响该实体的移动速度。越大的值会造成越小的摩擦。
minecraft:geometry 字符串 要使用的几何描述标识符，该标识符必须能够匹配上一个在当前任何已经加载的资源包中存在着的几何标识符。
需要实验性开关：假日创作者功能
minecraft:immovable 布尔值 一个不可以动的方块不能被活塞推动
minecraft:loot 字符串 该战利品表相对于行为包的路径。
minecraft:map_color 字符串 #RRGGBB 以一个十六进制值表示的一种颜色。它将作为渲染一张地图时该方块使用的颜色。设置当一个方块渲染到一张地图上时该方块的颜色。该颜色以一个十六进制值以“#RRGGBB”格式表示。也可以以一个[R, G, B]从0至255的数组表达。
minecraft:material_instances JSON 对象 方块的材质实例。
将一个面或位于一个几何文件中的material_instance名称映射到一个实际的材质实例上。材质实例可以是一个完整的材质实例，也可以是一个代表另一个已经定义的实例的名称。
需要实验性开关：假日创作者功能

Material Instance（材质实例）

要映射到几何文件中的材质实例的材质实例定义。材质实例 '*' 将用于任何没有匹配项的材质。

名称 类型 默认值 描述
ambient_occlusion 布尔值 true 此材质是否应在照明时应用环境光遮蔽。
face_dimming 布尔值 true 此材质是否应因其朝向而变暗。
render_method 字符串 opaque 要使用的渲染方法。必须是 'opaque'、'double_sided'、'blend' 或 'alpha_test' 之一。
texture 字符串 材质的纹理名称。
返回顶部
minecraft:onlypistonpush 布尔值 带有这个组件的方块不会黏在粘性活塞上。
minecraft:part_visibility JSON 对象 将一个几何文件中的骨骼名映射到一个可以控制它们渲染与否的条件的上。该条件应当为一个能够使用方块属性来确定true或false的Molang查询。支持的查询包括‘has_block_property’、‘block_property’和其他可以在不知道该方块的游戏内位置和玩家影响的数据的情况下可以进行计算的查询。
需要实验性开关：即将到来的创作者功能
minecraft:placement_filter JSON 对象 设置在何种条件下该方块可以被放置或存活

conditions（条件）

使该方块可以被放置或存活的条件的列表

名称 类型 默认值 描述
allowed_faces 数组 一下任意一种字符串的列表：up, down, north, south, east, west, side, all
block_filter 数组 该方块可以在allowed_faces的方向上被放置在的方块的列表（可以使用标签来指定它们）
返回顶部
minecraft:preventsjumping 布尔值 该组件可以使活动对象无法于走在该方块上时跳跃
minecraft:random_ticking JSON 对象 描述了该组件将会在两个值之间的区间上定期触发一个事件
名称 类型 默认值 描述
on_tick 触发器 将在 tick 上触发的事件
名称 类型 默认值 描述
condition 字符串 1 要执行在该方块上的事件的条件。
event 字符串 set_block_property 执行在该方块上的事件的类型。
range 数组 [10, 10] 该组件将要触发其事件的范围。
target 字符串 self 执行在该方块上的事件的目标对象。
minecraft:rotation 向量 [a, b, c] rotation[0, 0, 0] 这是该方块围绕该立方体中心的旋转角（角度制）。旋转值的顺序是x-y-z。
minecraft:ticking JSON 对象 描述了该组件将会在两个值之间的区间上定期触发一个事件
名称 类型 默认值 描述
looping 布尔值 true 该事件是否循环
on_tick 触发器 将在 tick 上触发的事件
名称 类型 默认值 描述
condition 字符串 1 要执行在该方块上的事件的条件。
event 字符串 set_block_property 执行在该方块上的事件的类型。
range 数组 [10, 10] 该组件将要触发其事件的范围。
target 字符串 self 执行在该方块上的事件的目标对象。
range 数组 [10, 10] 该组件将要触发其事件的范围。
minecraft:unit_cube JSON 对象 指定在镶嵌（曲面细分）时使用一个单位立方体。
需要实验性开关：假日创作者功能
minecraft:unwalkable 布尔值 false 设置该方块为不可行走。当该值设置为true时，生物不会尝试途经其上。
返回顶部

方块定义属性

这些属性是方块定义的一部分。这有助于系统确定如何解析和初始化该方块。

名称 类型 默认值 描述
format_version 字符串 指定制作该实体的游戏的版本。如果该版本比当前版本低，则任何对原版版本中的实体做出的变更都将应用到它身上。

代码示例

示例

返回顶部

方块描述属性

名称 类型 默认值 描述
identifier 字符串 该方块的标识符。该名称必须包含一个命名空间，而且除非想要覆写一个原版方块，否则不可以使用minecraft命名空间。
返回顶部

方块事件响应

方块触发器组件的事件响应。

名称 类型 默认值 描述
add_mob_effect JSON 对象 将生物效果应用到目标对象。
名称 类型 默认值 描述
amplifier 整数 0 该生物效果的倍率。
duration 小数 0.0 该生物效果的持续时间。
effect 字符串 要应用的生物效果。
target Minecraft 过滤器 self 要对其执行的目标对象上下文。
damage JSON 对象 对该目标对象结算伤害。
名称 类型 默认值 描述
amount 整数 0 要结算的伤害的数量。
target Minecraft 过滤器 self 要对其执行的目标对象上下文。
type 字符串 要结算的伤害的类型。
decrement_stack JSON 对象 自减物品堆叠。
die JSON 对象 杀死目标对象。如果目标对象是self且该事件运行自一个方块，则摧毁该方块。
名称 类型 默认值 描述
target Minecraft 过滤器 self 要对其执行的目标对象上下文。
play_effect JSON 对象 相对于目标对象的位置生成一个粒子效果。
名称 类型 默认值 描述
data 整数 0 粒子数据值。
effect 字符串 要创建的粒子效果的名称。
target Minecraft 过滤器 self 要对其执行的目标对象上下文。
play_sound JSON 对象 相对于目标对象的位置播放一个声音。
名称 类型 默认值 描述
sound 字符串 要播放的声音的名称。
target Minecraft 过滤器 self 要对其执行的目标对象上下文。
remove_mob_effect JSON 对象 从目标对象上移除生物效果。
名称 类型 默认值 描述
effect 字符串 要移除的生物效果。使用 'all' 以从目标对象上移除所有生物效果。
target Minecraft 过滤器 self 要对其执行的目标对象上下文。
run_command JSON 对象 触发一个斜杠命令或一个斜杠命令的列表。
名称 类型 默认值 描述
command 字符串 要运行的斜杠命令。
command 数组 数组 要运行的斜杠命令的列表。
target Minecraft 过滤器 self 要对其执行的目标对象上下文。
set_block JSON 对象 要将该方块设置为另一个方块类型。
名称 类型 默认值 描述
block_type 字符串 要设置的方块的类型。
set_block_at_pos JSON 对象 将相对于该方块的一个方块设置为另一个方块类型。
名称 类型 默认值 描述
block_offset 向量 [a, b, c] [0.0, 0.0, 0.0] 从该方块的中心的偏移量。
block_type 字符串 要设置的方块的类型。
set_block_property JSON 对象 在该方块上设置一个方块属性。
名称 类型 默认值 描述
property Molang 要在该方块上设置的方块属性。
spawn_loot JSON 对象 从方块生成一次战利品。
名称 类型 默认值 描述
table 字符串 相对于行为包的路径到该战利品表文件的文件路径
swing JSON 对象 可以造成活动对象挥摆的事件
teleport JSON 对象 将目标对象随机传送到目的地点周围。
名称 类型 默认值 描述
avoid_water 布尔值 true 确定该次传送是否避免将目标对象放置在水中。
destination 向量 [a, b, c] [0.0, 0.0, 0.0] 该次传送的原始目的地。
land_on_block 布尔值 true 确定该次传送是否将目标对象放置在一个方块上。
max_range 向量 [a, b, c] [8.0, 8.0, 8.0] 该目标对象能够相对于原始目的地传送的最大范围。
target Minecraft 过滤器 self 要对其执行的目标对象上下文。
transform_item JSON 对象 将物品转化为另一个物品。
名称 类型 默认值 描述
transform 字符串 该物品应当转化为的物品的名称。

代码示例

事件响应示例

返回顶部

方块触发器组件

名称 类型 默认值 描述
minecraft:on_fall_on JSON 对象 描述了该方块的事件。
名称 类型 默认值 描述
condition 字符串 要执行在该方块上的事件的条件。
event 字符串 执行在该方块上的事件。
min_fall_distance 小数 0.0 一个活动对象想要触发该事件所需下落的最小距离（以方块为单位）。
target 字符串 self 执行在该方块上的事件的目标对象。
minecraft:on_interact JSON 对象 描述了该方块的事件。
名称 类型 默认值 描述
condition 字符串 要执行在该方块上的事件的条件。
event 字符串 执行在该方块上的事件。
target 字符串 self 执行在该方块上的事件的目标对象。
minecraft:on_placed JSON 对象 描述了该方块的事件。
名称 类型 默认值 描述
condition 字符串 要执行在该方块上的事件的条件。
event 字符串 执行在该方块上的事件。
target 字符串 self 执行在该方块上的事件的目标对象。
minecraft:on_player_destroyed JSON 对象 描述了该方块的事件。
名称 类型 默认值 描述
condition 字符串 要执行在该方块上的事件的条件。
event 字符串 执行在该方块上的事件。
target 字符串 self 执行在该方块上的事件的目标对象。
minecraft:on_player_placing JSON 对象 描述了该方块的事件。
名称 类型 默认值 描述
condition 字符串 要执行在该方块上的事件的条件。
event 字符串 执行在该方块上的事件。
target 字符串 self 执行在该方块上的事件的目标对象。
minecraft:on_step_off JSON 对象 描述了该方块的事件。
名称 类型 默认值 描述
condition 字符串 要执行在该方块上的事件的条件。
event 字符串 执行在该方块上的事件。
target 字符串 self 执行在该方块上的事件的目标对象。
minecraft:on_step_on JSON 对象 描述了该方块的事件。
名称 类型 默认值 描述
condition 字符串 要执行在该方块上的事件的条件。
event 字符串 执行在该方块上的事件。
target 字符串 self 执行在该方块上的事件的目标对象。
返回顶部