方块格式历史

1.21.80 ​

组件 ​

• 将minecraft:destruction_particles移出实验性阶段
• 更新minecraft:map_color
  • 将tint_method参数移出实验性阶段
• 更新minecraft:material_instances
  • 更新render_method实例参数，新增3种渲染方法：
    • alpha_test_to_opaque：当方块在渲染距离一半以内时使用alpha_test渲染面，远处则使用opaque
    • alpha_test_single_sided_to_opaque：当方块在渲染距离一半以内时使用alpha_test_single_sided渲染面，远处则使用opaque
    • blend_to_opaque：当方块在渲染距离一半以内时使用blend渲染面，远处则使用opaque
  • 将isotropic实例参数移出实验性阶段
  • 将tint_method实例参数移出实验性阶段
• 更新minecraft:destruction_particles
  • 将texture参数改为可选
  • 默认情况下，粒子会使用down材质实例的纹理（若未指定则使用*）

• 移除minecraft:custom_components

  • 自定义组件现在应与原版组件一样作为components对象的条目应用：

    minecraft:block
    json

    "components": {
        "minecraft:friction": 0.4,
        "wiki:custom_component": {
            "parameter": "value"
        }
    }

    1
    2
    3
    4
    5
    6
    

1.21.70 ​

组件 ​

• 新增minecraft:replaceable
  • 允许通过尝试在其位置放置另一个方块来替换此方块的空对象
  • 不允许被相同变体的方块替换
• 更新minecraft:map_color
  • 现在可定义为包含以下参数的对象：
    • color：该方块在地图上的基础HEX字符串颜色

• 更新minecraft:map_color
  • 新增tint_method参数，允许根据方块所在的生物群系对color进行着色
• 更新minecraft:material_instances
  • 新增isotropic实例参数，决定面UV是否根据方块在世界中的位置随机旋转
  • 新增tint_method实例参数，使texture根据方块所在的生物群系着色（作为物品时始终为plains）

• 新增minecraft:destruction_particles
  • 决定攻击、破坏、踩踏和跌落方块时产生的粒子外观
  • 包含texture：指定从RP/textures/terrain_texture.json使用的纹理图集简称
  • 包含tint_method：使texture根据方块所在的生物群系着色

1.21.60 ​

描述 ​

• 更新menu_category
  • 更新group参数，要求使用命名空间（如minecraft:itemGroup.name.concrete）

组件 ​

• 将minecraft:item_visual移出实验性阶段
• 将minecraft:liquid_detection移出实验性阶段
• 更新minecraft:material_instances
  • 将浮点值支持从实验性阶段移出ambient_occlusion

1.21.50 ​

组件 ​

• 更新minecraft:destructible_by_mining
  • 将item_specific_speeds参数移出实验性阶段

• 新增minecraft:item_visual
  • 决定该方块作为物品时的显示方式
  • 包含geometry：决定显示的几何组件
  • 包含material_instances：决定显示的材质实例组件
• 新增minecraft:liquid_detection
  • 决定该方块与不同类型液体的交互方式
  • 包含detection_rules，每条规则包含以下参数：
    • liquid_type：决定该规则适用的液体类型（目前仅支持water）
    • can_contain_liquid：决定该液体类型是否能与该方块共存（如水logging）
    • on_liquid_touches：决定液体流入方块时的行为
    • stops_liquid_flowing_from_direction：决定液体不能从哪些方向流出该方块的数组
• 更新minecraft:material_instances
  • 更新ambient_occlusion实例参数，支持决定环境遮挡强度(0.0-10.0)的浮点数

1.21.40 ​

组件 ​

• 将minecraft:redstone_conductivity移出实验性阶段

1.21.30 ​

组件 ​

• 新增minecraft:redstone_conductivity
  • 包含redstone_conductor：决定该方块是否传导红石信号
  • 包含allows_wire_to_step_down：决定红石线能否从该方块侧面向下传输
• 更新minecraft:destructible_by_mining
  • 新增item_specific_speeds：决定数组中每个item描述符的destroy_speed

1.21.10 ​

组件 ​

• 将minecraft:custom_components移出实验性阶段
• 将minecraft:entity_fall_on移出实验性阶段
• 将minecraft:tick移出实验性阶段

1.21.0 ​

组件 ​

• 更新minecraft:transformation
  • 新增scale_pivot参数
  • 新增rotation_pivot参数

1.20.80 ​

• 移除events

组件 ​

• 新增minecraft:custom_components
  • 列出应应用于此方块的所有自定义组件
• 新增minecraft:entity_fall_on
  • 包含min_fall_distance：决定触发实体跌落事件的最小跌落距离
• 将minecraft:queued_ticking重命名为minecraft:tick
  • 移除on_tick参数

• 移除minecraft:on_fall_on触发器
• 移除minecraft:on_interact触发器
• 移除minecraft:on_placed触发器
• 移除minecraft:on_player_destroyed触发器
• 移除minecraft:on_player_placing触发器
• 移除minecraft:on_step_off触发器
• 移除minecraft:on_step_on触发器
• 移除minecraft:random_ticking触发器

事件 ​

• 移除add_mob_effect响应
• 移除damage响应
• 移除decrement_stack响应
• 移除die响应
• 移除play_effect响应
• 移除play_sound响应
• 移除remove_mob_effect响应
• 移除run_command响应
• 移除set_block响应
• 移除set_block_at_pos响应
• 移除set_block_state响应
• 移除spawn_loot响应
• 移除swing响应
• 移除teleport响应
• 移除transform响应
• 移除trigger响应

1.20.60 ​

组件 ​

• 更新minecraft:geometry
  • 新增culling参数：决定应用于此方块模型的剔除规则

• 移除minecraft:unit_cube

1.20.20 ​

描述 ​

• 将traits移出实验性阶段

特性 ​

• 将minecraft:placement_direction移出实验性阶段
• 将minecraft:placement_position移出实验性阶段

1.20.10 ​

描述 ​

• 将properties重命名为states

组件 ​

• 更新minecraft:geometry
  • 为bone_visibility条目添加Molang变体条件支持

事件 ​

• 将set_block_property响应重命名为set_block_state

1.20.0 ​

描述 ​

• 新增traits
  • 方块特性是创作者为数据驱动方块添加原版状态和值设置器的快捷方式

特性 ​

• 新增minecraft:placement_direction
  • 可启用minecraft:cardinal_direction和minecraft:facing_direction状态
• 新增minecraft:placement_position
  • 可启用minecraft:block_face和minecraft:vertical_half状态

1.19.80 ​

组件 ​

• 新增minecraft:transformation
  • 包含决定方块模型和碰撞变换的rotation、scale和translation
• 更新minecraft:geometry
  • 新增bone_visibility参数：根据布尔值决定骨骼立方体的可见性

• 移除minecraft:part_visibility

1.19.70 ​

描述 ​

• 将properties移出实验性阶段

变体 ​

• 移出实验性阶段
• 如果condition参数不是有效的Molang变体条件，方块将无法加载

1.19.60 ​

组件 ​

• 将minecraft:display_name移出实验性阶段
• 将minecraft:placement_filter移出实验性阶段
• 将minecraft:selection_box移出实验性阶段

1.19.50 ​

组件 ​

• 将minecraft:crafting_table移出实验性阶段
• 将minecraft:collision_box移出实验性阶段

• 移除minecraft:breathability

1.19.40 ​

描述 ​

• 更新menu_category
  • 新增is_hidden_in_commands参数：决定在命令中使用时是否将该方块视为无效

组件 ​

• 将minecraft:geometry移出实验性阶段
• 将minecraft:material_instances移出实验性阶段
• 移除minecraft:breathability
• 将minecraft:block_light_filter重命名为minecraft:light_dampening

1.19.30 ​

描述 ​

• 新增menu_category
  • 包含category：决定该方块所属的标签页
  • 包含group：决定该方块与其他物品的分组关系

组件 ​

• 移除minecraft:creative_category
• 更新minecraft:display_name
  • 不再在显示名称前添加tile.和后缀.name

1.19.20 ​

组件 ​

• 将minecraft:block_light_emission重命名为minecraft:light_emission
  • 现在以整数光照等级(0-15)而非小数(0.0-1.0)决定发射光量
• 用minecraft:destructible_by_mining替换minecraft:destroy_time
  • 设为false可防止通过挖掘破坏方块
  • 设为true允许立即挖掘和破坏方块
  • 设为对象可决定seconds_to_destroy
• 用minecraft:destructible_by_explosion替换minecraft:explosion_resistance
  • 设为false可防止通过爆炸破坏方块
  • 设为true允许轻松通过爆炸破坏方块
  • 设为对象可决定explosion_resistance
• minecraft:friction的值现在代表移动阻力而非移动速度

• 移除minecraft:unwalkable
• 将minecraft:aim_collision重命名为minecraft:selection_box

1.19.10 ​

组件 ​

• 将minecraft:block_light_filter重命名为minecraft:light_dampening
• 更新minecraft:flammable
  • 现在可设为布尔值，false表示方块不可燃，true使用默认可燃值
  • 将flame_odds参数重命名为catch_chance_modifier
  • 将burn_odds参数重命名为destroy_chance_modifier

• 将minecraft:block_collision重命名为minecraft:collision_box
• 更新minecraft:crafting_table
  • 将custom_description参数重命名为table_name
  • 移除grid_size参数
• 将minecraft:ticking重命名为minecraft:queued_ticking
  • 将range参数替换为以tick而非秒为单位的interval_range

• 更新minecraft:part_visibility
  • 将rules参数重命名为conditions

1.18.30 ​

组件 ​

• 移除minecraft:breakonpush
• 移除minecraft:immovable
• 移除minecraft:onlypistonpush
• 移除minecraft:preventsjumping

1.18.10 ​

组件 ​

• 将minecraft:block_light_absorption重命名为minecraft:block_light_filter

• 将minecraft:entity_collision重命名为minecraft:block_collision
• 将minecraft:pick_collision重命名为minecraft:aim_collision

1.18.0 ​

组件 ​

• 新增minecraft:crafting_table
  • 包含crafting_tags：通过标签决定支持的配方
  • 包含custom_description：将在UI中显示而非"工作台"
  • 包含grid_size：决定合成网格的槽位数（唯一支持值为3）

1.17.30 ​

组件 ​

• 新增minecraft:part_visibility
  • 根据molang变体条件决定模型中骨骼直接子项的可见性

1.17.20 ​

组件 ​

• 新增minecraft:creative_category
  • 决定该方块在创造模式菜单中的位置

1.16.210 ​

事件 ​

• 更新decrement_stack响应
  • 新增ignore_game_mode参数：决定玩家在创造模式时是否减少堆叠数

1.16.100 ​

• 新增`events