minecraft:block_light_absorption | 数值 | 未设置 | 旧组件,仅用于format_version低于1.19.40的内容。表示光穿过方块时被削减的等级,范围为0到15;新内容应使用minecraft:light_dampening。 |
minecraft:block_light_emission | 数值 | 未设置 | 旧组件,仅用于format_version低于1.19.40的内容。表示方块发光等级,范围为0到15;新内容应使用minecraft:light_emission。 |
minecraft:chest_obstruction | 对象 | 未设置 | 控制箱子开启时如何判断该方块阻挡箱盖。obstruction_rule为字符串,默认值为shape。在1.26.20之前的格式版本中需要“Upcoming Creator Features”。 |
minecraft:collision_box | 布尔值或对象 | 完整碰撞箱 | 定义实体碰撞箱。true使用默认完整方块,false禁用实体碰撞;对象形态使用origin和size,两者相加必须落在[-8,0,-8]到[8,24,8]范围内。 |
minecraft:connection_rule | 对象 | 未设置 | 定义栅栏、墙、铁栏杆、玻璃板等是否可连接到该方块。accepts_connections_from默认值为all;enabled_directions默认启用north、south、east和west。在1.26.0之前的格式版本中需要“Upcoming Creator Features”。 |
minecraft:crafting_table | 对象 | 未设置 | 使方块打开自定义合成台界面。仅支持有序配方和无序配方。crafting_tags最多64个标签,每个标签最多64个字符;table_name为界面标题的本地化键。 |
minecraft:destroy_time | 数值 | 未设置 | 旧组件,仅用于format_version低于1.19.40的内容。表示基础工具破坏耗时;新内容应使用minecraft:destructible_by_mining。 |
minecraft:destructible_by_explosion | 布尔值或对象 | 默认爆炸抗性 | 控制爆炸能否破坏方块。true使用默认爆炸抗性,false表示不可被爆炸破坏;对象形态使用explosion_resistance设置爆炸抗性,默认值为0。 |
minecraft:destructible_by_mining | 布尔值或对象 | 默认破坏耗时 | 控制开采破坏耗时。true使用默认耗时,false表示不可开采破坏;对象形态使用seconds_to_destroy和item_specific_speeds。item_specific_speeds项包含item匹配项和destroy_speed。 |
minecraft:destruction_particles | 对象 | 未设置 | 设置方块被破坏时产生的粒子。particle_count默认100且最大255;texture指定粒子纹理;tint_method可为none、default_foliage、birch_foliage、evergreen_foliage、dry_foliage、grass或water。 |
minecraft:display_name | 字符串 | 方块名 | 设置物品栏和快捷栏悬停时显示的文本。字符串可为本地化键;无法解析为本地化键时会直接显示原始字符串。 |
minecraft:embedded_visual | 对象 | 未设置 | 设置方块嵌入另一个方块内部时使用的几何体和材质实例,例如花盆中的花。字段为geometry和material_instances,形态对应同名组件。 |
minecraft:entity_fall_on | 对象 | 1格 | 设置实体至少下落多少格后触发脚本自定义组件事件onEntityFallOn。字段minimum_fall_distance为十进制数。 |
minecraft:explosion_resistance | 数值 | 未设置 | 旧组件,仅用于format_version低于1.19.40的内容。新内容应使用minecraft:destructible_by_explosion。 |
minecraft:flammable | 布尔值或对象 | 不自然引燃 | 控制方块自然引燃和燃毁概率。true使用木板式默认值,false或省略时不会因邻近火焰自然着火,但仍可被直接点燃;对象形态使用catch_chance_modifier和destroy_chance_modifier,默认值分别为5和20。 |
minecraft:flower_pottable | 空对象 | 未设置 | 表示该方块可被放入花盆。 |
minecraft:friction | 数值 | 0.4 | 设置实体在方块上移动时的摩擦力,范围为0.0到0.9。值越大越不易滑动;冰的参考值为0.02。 |
minecraft:geometry | 字符串或对象 | 未设置 | 指定方块渲染几何体。可使用资源包中的几何体标识符,也可使用minecraft:geometry.full_block或minecraft:geometry.cross。对象形态可设置identifier、bone_visibility、culling、culling_layer、culling_shape和uv_lock。 |
minecraft:instrument_sound | 对象 | up为note.harp,down为note.none | 设置音符盒位于方块上方或下方时使用的乐器音色。字段up和down至少设置其一;可用note.none表示无声音。 |
minecraft:item_visual | 对象 | 未设置 | 设置该方块作为物品显示时使用的几何体和材质实例。字段geometry和material_instances均为必填,并映射到同名方块组件的结构。 |
minecraft:light_dampening | 数值 | 未设置 | 设置光穿过方块时被削减的等级,范围为0到15。0近似完全透明,15近似完全不透光;树叶参考值为1,水参考值为2。 |
minecraft:light_emission | 数值 | 未设置 | 设置方块发光等级,范围为0到15。火把参考值为14,荧石参考值为15,红石火把参考值为7,灵魂火把参考值为10。怪物不能在亮度等级不低于8的方块上生成。 |
minecraft:liquid_detection | 对象或对象数组 | 未设置 | 定义方块检测液体时的行为。每种液体类型只能使用一条规则;后续重复规则会被忽略。关键字段包括liquid_type、can_contain_liquid、on_liquid_touches、stops_liquid_flowing_from_direction和use_liquid_clipping。目前官方资料仅列出water液体类型。 |
minecraft:loot | 字符串 | 掉落自身 | 指定方块被破坏时使用的战利品表路径。路径相对于行为包根目录,例如loot_tables/blocks/example.json,字符串最长256个字符。 |
minecraft:map_color | 字符串、数组或对象 | 不显示在地图上 | 设置方块在地图上渲染的颜色。颜色可写为#RRGGBB字符串,也可写为[R,G,B]数组;对象形态还可设置tint_method。 |
minecraft:material_instances | 对象或字符串 | 未设置 | 将几何体中的面名或材质实例名映射到实际材质实例。面键包括*、up、down、north、south、east和west。材质实例可设置texture、render_method、ambient_occlusion、face_dimming、isotropic和tint_method。isotropic要求format_version不低于1.21.80。 |
minecraft:movable | 对象 | 未设置 | 控制方块被活塞等方块推动时的移动行为。movement_type为必填字段,默认语义为push_pull;sticky控制推动时如何处理相邻方块,默认值为none。在1.21.100之前的格式版本中需要“Upcoming Creator Features”。 |
minecraft:placement_filter | 对象 | 未设置 | 设置方块可以放置和保持存在的条件。conditions最多64项;每项可设置allowed_faces和block_filter。allowed_faces可用up、down、north、south、east、west、side和all,最多6个面。block_filter项可使用name、states和tags。 |
minecraft:precipitation_interactions | 对象 | 未设置 | 设置方块与雨雪的交互。precipitation_behavior为行为字符串。Microsoft Learn当前列出的值包括obrain、obstruct_rain_accumulate_snow和none;实际可用值应以目标版本内容日志校验为准。在1.21.120之前的格式版本中需要“Upcoming Creator Features”。 |
minecraft:random_offset | 对象 | 未设置 | 根据方块位置和指定范围随机偏移方块渲染位置、轮廓和碰撞。x、y、z分别包含range和steps;range包含min和max。 |
minecraft:redstone_conductivity | 对象 | 使用默认红石属性 | 设置基础红石导电属性,要求format_version不低于1.21.30。allows_wire_to_step_down默认true;redstone_conductor默认false。 |
minecraft:redstone_consumer | 对象 | 未设置 | 表示方块可消耗并可能传播红石信号。该组件不可用于方块置换。min_power设置最小输入信号强度,默认0;propagates_power控制是否让信号穿过该方块,默认false。 |
minecraft:redstone_producer | 对象 | 未设置 | 表示方块产生红石信号。power为0到15;connected_faces指定参与电路连接的面;strongly_powered_face指定被强充能的面;transform_relative为真时会随minecraft:transformation旋转相关面。 |
minecraft:replaceable | 空对象 | 未设置 | 表示其他方块可放置到同一位置并替换该方块。在1.21.60之前的格式版本中需要“Upcoming Creator Features”。 |
minecraft:selection_box | 布尔值或对象 | 完整选取箱 | 定义玩家准星选中方块时显示的选取箱。true使用完整方块,false使方块不可被准星选中;对象形态使用origin和size,两者相加必须落在[-8,0,-8]到[8,16,8]范围内。 |
minecraft:support | 对象 | 单位立方体支撑 | 定义方块的支撑形状。shape为必填字段,目前官方列出fence和stair。自定义楼梯支撑通常还需要通过方块特质启用minecraft:vertical_half和minecraft:cardinal_direction或minecraft:facing_direction。 |
tag:<标签名> | 空对象 | 未设置 | 为方块添加标签。创作者可以创建自己的标签,但只有原版方块标签可使用minecraft:命名空间。原版标签表见原版方块标签。 |
minecraft:tick | 对象 | 未设置 | 使方块按随机选取的固定间隔触发脚本自定义组件onTick事件。interval_range为刻数范围,默认[0,0];looping默认true。监听onTick的自定义组件若添加到没有该组件的方块上,会产生内容错误。 |
minecraft:transformation | 对象 | 未设置 | 设置方块相对世界位置中心的平移、旋转和缩放。字段包括translation、rotation、scale、rotation_pivot和scale_pivot;rotation使用90度增量。 |