方块组件写在行为包中方块文件的 components 对象里:它们决定自定义方块是什么、能做什么。这里列出了 Minecraft 1.26.50.4 中的全部 49 个。
49 / 49
组件
minecraft:block_entity让每个放置的方块都拥有自己保存的数据,这样一个方块可以记住相邻方块不知道的东西。适用于存储方块或需要被脚本追踪的方块。minecraft:breathability决定生物和玩家在方块里面能否呼吸。植物或镂空框架这类方块用 "air",用 "solid" 会让卡在里面的人开始窒息。minecraft:chest_obstruction决定这个方块是否会挡住下方箱子的打开。minecraft:collision_box设置方块中玩家、生物和物品会撞到的实体部分。设为 false 后所有东西都能直接穿过,就像高草丛;也可以为台阶等小形状设置更小的碰撞箱。minecraft:connection_rule控制栅栏、墙、铁栏杆和玻璃板放在这个方块旁边时是否会与它连接。minecraft:crafting_table把方块变成一个合成台,打开 3x3 的合成界面。带有匹配标签的配方可以在上面合成。minecraft:destructible_by_explosion控制方块抵抗 TNT、苦力怕和其他爆炸的能力。设为 false 让方块完全防爆。minecraft:destructible_by_mining控制徒手或用工具破坏方块需要多长时间。设为 false 让方块像基岩一样无法挖掘。minecraft:destruction_particles设置方块被破坏时飞出的小碎片。minecraft:display_name设置玩家在物品栏和提示框中看到的方块名称。填写 .lang 文件中的翻译键,名称就能随语言变化;也可以直接填普通文本。minecraft:embedded_visual设置方块位于另一个方块内部时的外观,例如种在花盆里的时候。minecraft:entity_fall_on设置生物或玩家至少要从多高摔到这个方块上才算落地,让脚本可以对落地做出反应。minecraft:flammable让附近的火焰可以蔓延到方块上并把它烧掉,就像木头一样。没有它的话,方块只有被直接点燃才会燃烧。minecraft:flower_pottable让玩家可以把这个方块放进空花盆。搭配 minecraft:embedded_visual 来决定它在花盆里的样子。minecraft:friction设置在方块上行走时的滑度,范围 0.0 到 0.9。数值越高抓地力越强,移动减速越明显;数值越低越滑。minecraft:geometry选择绘制方块的 3D 模型。你可以只填模型名称,也可以填一个带有隐藏骨骼或剔除等额外选项的对象。内置形状有 "minecraft:geometry.full_block" 和 "minecraft:geometry.cross"。minecraft:instrument_sound选择这个方块在音符盒上方或下方时音符盒发出的声音。把 "up" 和/或 "down" 设为某个音符音效;用 "note.none" 表示静音。minecraft:item_visual通过给方块物品单独的模型和纹理,设置它在手中和物品栏里的外观。当物品需要和放置的方块长得不一样时使用。minecraft:leashable让玩家可以把拴绳系在方块上,就像栅栏柱一样。minecraft:light_dampening设置光线穿过方块时被吸收的程度,范围 0 到 15。玻璃这类透明方块用 0,用 15 则完全挡住光线。minecraft:light_emission让方块发光,范围从 0(不发光)到 15(和火把或荧石一样亮)。minecraft:liquid_detection决定水接触方块时会发生什么:可以把水留在方块里(含水)、让水流过,或者让方块破坏。每种液体只使用第一条规则。minecraft:loot选择决定方块被破坏时掉落什么的战利品表。填写行为包内的路径,比如 "loot_tables/blocks/my_block.json"。minecraft:map_color设置方块在地图上显示的颜色。可以只填一个颜色,也可以填带有生物群系着色的颜色。minecraft:material_instances为方块模型的各个面分配纹理和渲染设置。用 "*" 表示所有面,或用 "up"、"down"、"north" 等名称表示单个面。minecraft:movable控制活塞推动或拉动方块时会发生什么。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:placement_filter限制方块可以放在哪里,并在支撑物消失时让方块被破坏,就像需要下方有泥土的花一样。minecraft:precipitation_interactions决定方块如何对待落在上面的雨和雪。minecraft:queued_ticking在延迟后运行一个事件,可以只运行一次,也可以反复运行。延迟从一个刻数范围中随机选取(20 刻为 1 秒)。minecraft:random_offset根据方块的位置让它稍微偏离中心,就像排列得不那么整齐的花和草。偏移会同时移动轮廓线和碰撞箱,并且始终保持在方块空间内。minecraft:random_ticking在随机的时间不时运行一个事件,和农作物生长的方式一样。频率取决于 randomTickSpeed 游戏规则。minecraft:redstone_conductivity设置方块周围有红石时的表现。对于玻璃这类不应传导信号的方块,可以关闭传导。minecraft:redstone_consumer让方块可以接收红石信号,这样脚本能在信号变化时做出反应。适用于自定义灯、门和机器。minecraft:redstone_producer让方块发出红石信号,就像红石块或打开的拉杆一样。minecraft:replaceable让另一个方块可以直接放在这个方块的位置并替换它,就像在高草丛或雪层上放方块会把它们替换掉一样。minecraft:selection_box设置玩家可以指向和点击的方块部分,也就是显示轮廓线的范围。设为 false 后方块完全无法被选中。minecraft:sound选择方块在放置、破坏和被踩踏时发出的一组声音。minecraft:support让方块拥有栅栏或楼梯的支撑形状,其他方块可以用同样的方式附着在上面。自定义楼梯还需要 placement_direction 特性提供的垂直半边和朝向状态。minecraft:tags给方块添加标签,让工具、配方和脚本可以按分组找到它,比如 "minecraft:is_pickaxe_item_destructible"。标签写成 "namespace:name" 的形式。minecraft:tick让方块在延迟后运行它的刻事件,可以只运行一次,也可以反复运行。延迟从一个刻数范围中随机选取(20 刻为 1 秒)。minecraft:transformation以方块空间的中心为基准,移动、旋转或缩放方块的外观。配合方块状态使用,可以让方块朝向不同方向。minecraft:unit_cube把方块绘制成一个普通的完整立方体。这是较旧的选项,使用 "minecraft:geometry.full_block" 的 minecraft:geometry 效果相同。