跳到主要内容

方块组件

收录所有已开放或即将开放的命名空间为minecraft和netease的方块组件信息。

你可以使用Ctrl+F来查找你需要的条目。

本文更新时间

本文于 2025 年 9 月 3 日更新，中国版最新版本为 1.21.0，国际版最新版本为 1.21.100。

组件可用性提示

  1. 标签记号说明：

    • 标注了国际版 旧版的组件，代表其为旧版国际版组件，可应用于国际版方块定义（在行为包blocks 文件图标blocks定义的方块）。format_version必须指定1.10.0~1.16.0以内时才可使用。

    • 标注了国际版 版本号+的组件，代表其为新版国际版组件，可应用于国际版方块定义（在行为包blocks 文件图标blocks定义的方块）。其中，（版本号）代表方块定义的format_version必须指定为该版本号或更高才可使用。

    • 标注了中国版的组件，代表其为中国版组件，可应用于中国版方块定义（在行为包netease_blocks 文件图标netease_blocks定义的方块）。

    • 标注了国际版的组件，代表其为实验性玩法组件，可应用于国际版方块定义（在行为包blocks 文件图标blocks定义的方块）。本文档不记载已被移除的实验性玩法组件（尤其是假日创作者功能的组件）。开发者在使用这些组件的时候应当万分小心，因为它们随时可能会被移除，这会导致你的资源的关键功能失效。

    • 注意：中国版可以同时使用国际版方块定义和中国版方块定义，但是国际版只能使用国际版方块定义。

  2. 如果官方文档中有记载，以上这些标签将会链接到官方文档，读者可点击以查看对应文档。

minecraft:block_light_absorption​

国际版 旧版 中国版

定义方块会吸收光，降低光照等级。

新版组件替代

该组件在更高版本中用minecraft:light_dampening代替。你可以在这里的旧版文档中查看该组件接受的参数。

格式版本 1.16.0 以前：

  • minecraft:block_light_absorption 数据类型图标minecraft:block_light_absorption：根对象
    • value 数据类型图标value：定义方块会吸收多少光照等级（也可以代表其透光度）。应在0-15之间（含），如不指定该组件则指定该方块不透光。

格式版本 1.16.X：

  • minecraft:block_light_absorption 数据类型图标minecraft:block_light_absorption：定义方块会吸收多少光照等级（也可以代表其透光度）。应在0-15之间（含），如不指定该组件则指定该方块不透光。

minecraft:block_light_emission​

国际版 旧版 中国版

定义方块会发出光，提供光照等级。

新版组件替代

该组件在更高版本中用minecraft:light_emission代替。你可以在这里的旧版文档中查看该组件接受的参数。

格式版本 1.16.0 以前：

  • minecraft:block_light_emission 数据类型图标minecraft:block_light_emission：根对象
    • emission 数据类型图标emission：定义方块发出的光照强度。应在0.0-1.0之间（含），如不指定该组件则指定该方块不发光。

格式版本 1.16.X：

  • minecraft:block_light_emission 数据类型图标minecraft:block_light_emission：定义方块发出的光照强度。应在0.0-1.0之间（含），如不指定该组件则指定该方块不发光。

嗯对，你没看错，是[0.0, 1.0]，不是[0, 15]，例如 1.0 代表 15 的光照强度。注意别写错了哦。

minecraft:collision_box​

国际版 1.19.50+

定义方块的碰撞箱。

minecraft:crafting_table​

国际版 1.19.20+

定义方块为一种工作台。

minecraft:custom_components​

国际版 1.21.20 - 1.21.90+

定义方块的自定义组件。自定义组件的行为需要在世界初始化前事件WorldInitializeBeforeEvent中定义。

minecraft:destroy_time​

国际版 旧版 中国版

定义方块的挖掘时长。

新版组件替代

该组件在更高版本中用minecraft:destructible_by_mining代替。你可以在这里的旧版文档中查看该组件接受的参数。

格式版本 1.16.0 以前：

  • minecraft:destroy_time 数据类型图标minecraft:destroy_time：根对象
    • value 数据类型图标value：定义方块的破坏时长。

格式版本 1.16.X：

  • minecraft:destroy_time 数据类型图标minecraft:destroy_time：定义方块的破坏时长。

注意：这里的破坏时长实际上为硬度的概念。在一般情况下，破坏时长（秒）是硬度的 1.5 倍，比如硬度为 1 时，需要 1.5 秒破坏。

minecraft:destructible_by_explosion​

国际版 1.19.20+

定义方块是否可被爆炸破坏，及其爆炸抗性。

minecraft:destructible_by_mining​

国际版 1.19.20+

定义方块是否可被挖掘，及其挖掘时长。

minecraft:destruction_particles​

国际版 1.21.70+

定义方块被破坏后掉落的粒子。

minecraft:display_name​

国际版 1.19.60+

定义方块在物品栏的悬浮文本。

minecraft:embedded_visual​

国际版 1.21.110+

定义了方块嵌入另一方块（如花盆）时需要使用的geometry和​material_instances。

警告

要使用该组件，必须启用“即将到来的创作者功能”实验性玩法。需要注意：启用实验性玩法可能会导致游戏不稳定，并且正在实验性玩法的组件有可能会在后续的版本中被移除。

minecraft:entity_fall_on​

国际版 1.21.10+

定义实体在多高处落到该方块上之后，才能触发 ScriptAPI 中自定义方块组件定义的onEntityFallOn事件。

minecraft:explosion_resistance​

国际版 旧版 中国版

定义方块的爆炸抗性。

新版组件替代

该组件在更高版本中用minecraft:destructible_by_explosion代替。你可以在这里的旧版文档中查看该组件接受的参数。

格式版本 1.16.0 以前：

  • minecraft:explosion_resistance 数据类型图标minecraft:explosion_resistance：根对象
    • value 数据类型图标value：定义方块的爆炸抗性。

格式版本 1.16.X：

  • minecraft:explosion_resistance 数据类型图标minecraft:explosion_resistance：定义方块的爆炸抗性。

minecraft:flammable​

国际版 旧版 国际版 1.19.10+

定义方块为可燃方块。

格式版本 1.16.X 及更低：

  • minecraft:flammable 数据类型图标minecraft:flammable：根对象
    • burn_odds 数据类型图标burn_odds：定义方块在燃烧时有多大可能被烧毁。
    • flame_odds 数据类型图标flame_odds：定义方块有多大可能被点燃。

格式版本 1.19.10 及更高（布尔型）：

  • minecraft:flammable 数据类型图标minecraft:flammable：定义方块是否可燃。指定为true时将使用默认值。

格式版本 1.19.10 及更高（对象型）：

  • minecraft:flammable 数据类型图标minecraft:flammable：根对象。
    • catch_chance_modifier 数据类型图标catch_chance_modifier：定义方块有多大可能被点燃。默认值为5（木板）。
    • destroy_chance_modifier 数据类型图标destroy_chance_modifier：定义方块在燃烧时有多大可能被烧毁。默认值为20（木板）。

minecraft:flower_pottable​

国际版 1.21.110+

定义方块为一种花盆。

警告

要使用该组件，必须启用“即将到来的创作者功能”实验性玩法。需要注意：启用实验性玩法可能会导致游戏不稳定，并且正在实验性玩法的组件有可能会在后续的版本中被移除。

minecraft:friction​

国际版 旧版 国际版 1.19.20+

定义方块的摩擦系数。

格式版本 1.16.0 以前：

  • minecraft:friction 数据类型图标minecraft:friction：根对象
    • value 数据类型图标value：定义方块的摩擦系数。摩擦系数越低则方块越光滑。应在0.0-0.9之间（含）。

格式版本 1.16.X 或 1.19.20 及更高：

  • minecraft:friction 数据类型图标minecraft:friction：定义方块的摩擦系数。摩擦系数越低则方块越光滑。应在0.0-0.9之间（含）。

minecraft:geometry​

国际版 1.21.10+

定义方块的模型。

minecraft:item_visual​

国际版 1.21.60+

定义方块在物品栏中的外观。

minecraft:light_dampening​

国际版 1.19.10+

定义方块会吸收光，降低光照等级。

minecraft:light_emission​

国际版 1.19.20+

定义方块会发出光，提供光照等级。

minecraft:liquid_detection​

国际版 1.21.60+

定义方块在接触到液体后的行为。

minecraft:loot​

国际版 旧版 国际版 中国版

定义方块被破坏后的战利品表。

格式版本 1.16.0 以前：

  • minecraft:loot 数据类型图标minecraft:loot：根对象
    • table 数据类型图标table：定义方块使用的战利品表，需带有loot_tables/和.json后缀。

格式版本 1.16.X 及更高：

  • minecraft:loot 数据类型图标minecraft:loot：定义方块使用的战利品表，需带有loot_tables/和.json后缀。

minecraft:max_stack_size​

中国版

定义方块物品最大堆叠数量。

minecraft:map_color​

国际版 旧版 国际版 中国版

定义方块在地图（物品）上显示的颜色。

格式版本 1.16.0 以前：

  • minecraft:map_color 数据类型图标minecraft:map_color：根对象
    • color 数据类型图标color：定义方块在地图物品上显示的颜色，应为颜色代码#RRGGBB。

格式版本 1.16.X 及更高：

  • minecraft:map_color 数据类型图标minecraft:map_color：定义方块在地图物品上显示的颜色，应为颜色代码#RRGGBB。

minecraft:material_instances​

国际版 1.19.40+

定义方块的材质实例。

minecraft:movable​

国际版 1.21.100+

定义方块是否可被活塞推动，及其属性。

minecraft:placement_filter​

国际版 1.19.60+

定义方块允许被放置或允许存在的条件。

minecraft:random_offset​

国际版 1.21.100+

定义方块的贴图如何随机产生偏移。

minecraft:redstone_conductivity​

国际版 1.21.40+

定义方块的红石导体属性。

minecraft:redstone_producer​

国际版 1.21.110+

定义方块产生红石信号。1

警告

要使用该组件，必须启用“即将到来的创作者功能”实验性玩法。需要注意：启用实验性玩法可能会导致游戏不稳定，并且正在实验性玩法的组件有可能会在后续的版本中被移除。

minecraft:replaceable​

国际版 1.21.70+

定义方块是否可被另一种方块在原位替代（类似于水、草丛或空气）。

minecraft:selection_box​

国际版 1.19.60+

定义方块的选择箱。

tag:(标签)​

国际版 ?+

定义方块的标签。

minecraft:tick​

国际版 1.21.10+

定义方块的更新频率，并触发 ScriptAPI 中自定义方块组件定义的onTick事件。

minecraft:transformation​

国际版 1.21.0+

定义方块的平移、旋转、缩放变换。

netease:aabb​

中国版

定义方块的碰撞箱。

netease:block_animate_random_tick​

中国版

定义方块会高频率随机更新，并触发 ModAPI 的BlockAnimateRandomTickEvent。

netease:block_chest​

中国版

定义方块的箱子功能。

netease:block_container​

中国版

定义方块为一种自定义容器。

netease:block_crafting_table​

中国版

定义方块为一种自定义工作台。

netease:block_entity​

中国版

定义方块的方块实体属性。

netease:block_properties​

中国版

定义方块的属性。

编者注

这里的方块属性不等于方块状态，请注意在这里不要混淆概念。

netease:block_random_offset​

中国版

定义方块的偏移（类似于花）。

netease:can_built_over​

中国版

定义方块是否可被另一种方块在原位替代（类似于水、草丛或空气）。

netease:connection​

中国版

定义方块的连接属性。

netease:custom_tips​

中国版

定义方块物品的物品信息描述。

netease:face_directional​

中国版

定义方块的多面向功能。

netease:fall​

中国版

定义方块为重力方块，会受到重力的影响（类似于沙子）。

netease:fire_resistant​

中国版

定义方块的防火属性。

netease:fuel​

中国版

定义方块对应物品的燃料属性。

netease:liquid​

中国版

定义方块为一种自定义流体。

netease:listen_block_remove​

中国版

定义方块在被移除后会触发 ModAPI 的BlockRemoveServerEvent事件。

netease:may_place_on​

中国版

定义方块允许被放置或允许存在的条件。

netease:mob_spawner​

中国版

定义方块为一种自定义刷怪笼。

netease:neighborchanged_sendto_script​

中国版

定义方块在周围环境变化时，触发 ModAPI 的BlockNeighborChangedServerEvent事件。

netease:no_crop_face_block​

中国版

定义方块与其他方块的相邻面能够正常渲染（类似于树叶）。

netease:on_after_fall_on​

中国版

定义实体刚掉落到该方块上的时候是否触发 ModAPI 的OnAfterFallOnBlockClientEvent和OnAfterFallOnBlockServerEvent事件。

netease:on_before_fall_on​

中国版

定义实体刚掉落到该方块上的时候是否触发 ModAPI 的OnBeforeFallOnBlockServerEvent事件。

netease:on_entity_inside​

中国版

定义实体碰撞箱内有实体的时候是否触发 ModAPI 的OnEntityInsideBlockClientEvent和OnEntityInsideBlockServerEvent事件。

netease:on_stand_on​

中国版

定义当实体站在该方块后是否触发 ModAPI 的OnStandOnBlockClientEvent和OnStandOnBlockServerEvent事件。

netease:on_step_off​

中国版

定义当实体移动至该方块上后是否触发 ModAPI 的StepOffBlockClientEvent和StepOffBlockServerEvent事件。

netease:on_step_on​

中国版

定义当实体离开该方块上后是否触发 ModAPI 的StepOnBlockClientEvent和StepOnBlockServerEvent事件。

netease:pathable​

中国版

定义方块在实体 AI 寻路时是否被认作为障碍物。

netease:portal​

中国版

定义方块为一种自定义传送门。

netease:random_tick​

中国版

定义方块会随机更新，并触发 ModAPI 的BlockRandomTickServerEvent事件。

netease:redstone​

中国版

定义方块的红石电源元件或红石机械元件属性。

netease:redstone_property​

中国版

定义方块的红石属性。

netease:render_layer​

中国版

定义方块渲染材质。

netease:snow_recover_able​

中国版

定义方块是否可含雪（类似矮草丛、花等）。

netease:solid​

中国版

定义方块是否实心。

netease:tier​

中国版

定义方块的挖掘等级和挖掘相关属性。

netease:transform​

中国版

定义方块的转换条件。用于自定义农作物。

netease:water_flow_source​

中国版

定义方块在水源或水流中表现为含水方块。

netease:water_destroy​

中国版

定义方块会被水流摧毁，且无法放置在水中（类似红石粉、火把等）。

netease:water_only​

中国版

定义方块只能放置在水中（类似海带、海草等）。

netease:water_source​

中国版

定义方块在水源中表现为含水方块（类似台阶、楼梯等）。

参考文档​

本文主要参考文档如下，读者可以在这些文档获得更多信息。

Footnotes​

  1. 该组件于 1.21.110.25 加入，然而更新日志中并未提到该组件的参数信息和作用，需要验证。 ↩