方块

  本条目介绍的是方块开发信息。关于自定义方块教程，请见“Manual:方块”。

  关于更多信息，请见“Minecraft Wiki:方块”。

方块（Block）是游戏中最基本的组成单位。

行为

方块排列成每个单元为1立方米的网格，并与其对齐，这意味着方块中不能有多个单元，但存在台阶、藤蔓、雪、发光地衣‌^{[新增：BE 1.17.0]}、海龟蛋和海泡菜等例外。

方块和流体一起构成游戏内的环境，并能以各种各样的方式被收集和利用。一些方块，如泥土和砂岩是不透明方块，占据了整个空间，然而其他方块，如玻璃和花是透明或非固体的。爆炸摧毁这些方块比其他方块更容易。

空气是一种特殊方块。它是一种不可破坏的透明方块，作为没有方块时的替代物。

一些方块，如火把和荧石，能发出光亮，它们的亮度也各不相同（可参见亮度值表获取更多信息）。大多数不透明方块会完全挡光，但透明方块对光亮没有影响，或者只微弱地挡光。

几乎所有方块都会无视重力排列在网格中，除了沙子、红沙、沙砾、铁砧、龙蛋、混凝土粉末、脚手架和雪。

被破坏后的方块会发出相应的声音和粒子。

相关文件

方块/相关文件

相关组件

主页面：Manual:数据驱动 § 方块

描述

名称	类型	默认值	可用性	实验性玩法	走出实验版本	描述
base_block	字符串	无	仅中国版可用	N/A	N/A	设置方块的基方块。
category	字符串	无	仅中国版可用	N/A	N/A	设置方块的分组和分类。
identifier	字符串	无	可用	N/A	N/A	设置方块的赋命名空间标识符。
is_experimental	布尔值	false	已移除	N/A	N/A	设置方块是否属于实验性玩法。
material_type	字符串	无	仅中国版可用	N/A	N/A	设置方块的材料类型。
menu_category	对象	无	可用	N/A	N/A	设置方块的分组和分类。
micro_size	字符串	1 1 1	仅中国版可用	N/A	N/A	设置微缩方块的微缩尺寸。三个值依次为x，y，z三个轴方向上的尺寸，每两个值之间使用空格隔开。
register_to_creative_menu	布尔值	无	已移除	N/A	N/A	设置是否将方块注册到创造模式物品栏。
states	对象	无	可用	假日创作者功能	1.19.70	定义方块的属性。

组件

基础组件

名称	可用性	实验性玩法	走出实验版本	描述
minecraft:breakonpush	已移除	假日创作者功能	未走出
minecraft:breathability	已移除	假日创作者功能	未走出	设置该方块的透气性，以及是否将其视为固体或空气的属性。
minecraft:collision_box	可用	假日创作者功能	1.19.50	设置方块的碰撞箱。
minecraft:crafting_table	可用	假日创作者功能	1.19.50	设置与方块互动时打开一个合成界面。
minecraft:creative_category	已弃用	假日创作者功能	未走出	注册方块到创造模式物品栏及其分组。
minecraft:destructible_by_explosion	可用	N/A	N/A	设置方块是否可被爆炸破坏以及防爆属性。
minecraft:destructible_by_mining	可用	N/A	N/A	设置方块是否可被挖掘破坏以及破坏时间。
minecraft:display_name	可用	假日创作者功能	1.19.60	设置方块物品显示的悬浮文本。
minecraft:flammable	可用	N/A	N/A	设置方块的可燃性。
minecraft:friction	可用	N/A	N/A	设置方块的摩擦力。
minecraft:geometry	可用	假日创作者功能	1.19.40	设置方块模型。
minecraft:immovable	已移除	假日创作者功能	未走出
minecraft:light_dampening	可用	N/A	N/A	设置方块减弱的光照强度。(调整方块的透光强度，如果不设置，默认为不透光)
minecraft:light_emission	可用	N/A	N/A	设置方块发出的光照强度。
minecraft:loot	可用	N/A	N/A	设置方块的掉落物。
minecraft:map_color	可用	N/A	N/A	设置方块在地图上显示的颜色。
minecraft:material_instances	可用	假日创作者功能	1.19.40	将模型文件中的面或渲染映射到实际的纹理。
minecraft:onlypistonpush	已移除	假日创作者功能	未走出
minecraft:part_visibility	已弃用	即将到来的创作者功能	未走出	设置方块在指定条件下显示部分模型。
minecraft:placement_filter	可用	假日创作者功能	1.19.60	设置方块被放置时应满足的条件。
minecraft:preventsjumping	已移除	假日创作者功能	未走出
minecraft:queued_ticking	可用	假日创作者功能	未走出	计划刻计时器。
minecraft:random_ticking	可用	假日创作者功能	未走出	随机刻计时器。
minecraft:rotation	可用	假日创作者功能	未走出	设置方块围绕方块中心的旋转角度。
minecraft:selection_box	可用	假日创作者功能	1.19.60	设置方块的击中箱。
minecraft:unit_cube	可用	假日创作者功能	未走出	设置方块为单位方块。
minecraft:unwalkable	可用	假日创作者功能	未走出	设置该方块是否不能被越过。
netease:aabb	仅中国版可用	N/A	N/A
netease:block_entity	仅中国版可用	N/A	N/A
netease:block_legacy	仅中国版可用	N/A	N/A
netease:block_properties	仅中国版可用	N/A	N/A
netease:can_built_over	仅中国版可用	N/A	N/A
netease:connection	仅中国版可用	N/A	N/A
netease:face_directional	仅中国版可用	N/A	N/A
netease:fall	仅中国版可用	N/A	N/A
netease:fire_resistant	仅中国版可用	N/A	N/A
netease:liquid	仅中国版可用	N/A	N/A
netease:listen_block_remove	仅中国版可用	N/A	N/A
netease:may_place_on	仅中国版可用	N/A	N/A
netease:mob_spawner	仅中国版可用	N/A	N/A
netease:neighborchanged_sendto_script	仅中国版可用	N/A	N/A
netease:pathable	仅中国版可用	N/A	N/A
netease:portal	仅中国版可用	N/A	N/A
netease:random_tick	仅中国版可用	N/A	N/A
netease:render_layer	仅中国版可用	N/A	N/A
netease:redstone	仅中国版可用	N/A	N/A
netease:redstone_property	仅中国版可用	N/A	N/A
netease:snow_recover_able	仅中国版可用	N/A	N/A
netease:solid	仅中国版可用	N/A	N/A
netease:tier	仅中国版可用	N/A	N/A
netease:transform	仅中国版可用	N/A	N/A
netease:water_destory	仅中国版可用	N/A	N/A
netease:water_flow_source	仅中国版可用	N/A	N/A
netease:water_only	仅中国版可用	N/A	N/A
netease:water_source	仅中国版可用	N/A	N/A

触发器

名称	可用性	实验性玩法	走出实验版本	描述
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	可用	假日创作者功能	未走出	当实体踩上该方块时执行的事件。
netease:on_after_fall_on	仅中国版可用	N/A	N/A
netease:on_before_fall_on	仅中国版可用	N/A	N/A
netease:on_entity_inside	仅中国版可用	N/A	N/A
netease:on_stand_on	仅中国版可用	N/A	N/A
netease:on_step_off	仅中国版可用	N/A	N/A
netease:on_step_on	仅中国版可用	N/A	N/A

事件响应

名称	可用性	实验性玩法	走出实验版本	描述
add_mob_effect	可用	假日创作者功能	未走出	给目标添加状态效果。
damage	可用	假日创作者功能	未走出	对目标造成伤害。
decrement_stack	可用	假日创作者功能	未走出	使物品数量递减。
die	可用	假日创作者功能	未走出	清除目标。如果目标为self，并且这个事件由另一个方块执行，那么将摧毁该方块。
play_effect	可用	假日创作者功能	未走出	在相对于目标位置产生粒子效果。
play_sound	可用	假日创作者功能	未走出	在相对目标位置播放音频。
remove_mob_effect	可用	假日创作者功能	未走出	将目标移除状态效果。
run_command	可用	假日创作者功能	未走出	执行命令或命令列表。
set_block	可用	假日创作者功能	未走出	将该方块设置为另一种方块。
set_block_at_pos	可用	假日创作者功能	未走出	在相对于该方块的位置将一个方块设置为另一种方块。
set_block_property	可用	假日创作者功能	未走出	设置该方块的属性。
spawn_loot	可用	假日创作者功能	未走出	生成战利品。
swing	可用	假日创作者功能	未走出	使活动对象挥手。
teleport	可用	假日创作者功能	未走出	将目标随机传送到目的地周围。
transform_item	可用	假日创作者功能	未走出	将一个物品转换为另一个物品。

置换

名称	类型	默认值	可用性	实验性玩法	走出实验版本	描述
condition	字符串	无	可用	假日创作者功能	1.19.70	设置置换的条件。
components	对象	无	可用	假日创作者功能	1.19.70	设置置换的组件。

方块列表

主条目：赋命名空间标识符/列表/方块

材料

材料类型枚举

键名	值	接口字符串		描述
		AI意向	方块描述‌ ‌[仅中国版]
Air	0	Air	air	空气
Dirt	1	Dirt	dirt	泥土
Wood	2	Wood	wood	木质
Stone	3	Stone	stone	石质
Metal	4	Metal	metal	金属
Water	5	Water	water	水
Lava	6	Lava	lava	熔岩
Leaves	7	Leaves	leaves	树叶
Plant	8	Plant	plant	植物
SolidPlant	9	SolidPlant	—	固体植物
ReplaceablePlant	—	ReplaceablePlant	replaceable_plant	可替换植物
Sponge	10	Sponge	sponge	海绵
Cloth	11	Cloth	cloth	布质
Bed	12	Bed	bed	床
Fire	13	Fire	fire	火
Sand	14	Sand	sand	沙质
Decoration	15	Decoration	decoration	装饰物
Glass	16	Glass	glass	玻璃
Explosive	17	Explosive	explosive	爆炸物
Ice	18	Ice	ice	冰
PackedIce	19	PackedIce	packed_ice	浮冰
TopSnow	20	TopSnow	top_snow	顶层雪
Snow	21	Snow	snow	雪
PowderSnow	22	PowderSnow	—	细雪
Amethyst	23	Amethyst	—	紫水晶
Cactus	24	Cactus	cactus	仙人掌
Clay	25	Clay	clay	黏土
Vegetable	26	Vegetable	vegetable	蔬类
Portal	27	Portal	portal	传送门
Cake	28	Cake	cake	蛋糕
Web	29	Web	web	蜘蛛网
RedstoneWire	30	RedstoneWire	redstone_wire	红石线
Carpet	31	Carpet	carpet	地毯
BuildableGlass	32	BuildableGlass	buildable_glass	可建造玻璃
Slime	33	Slime	slime	粘液块
Piston	34	Piston	piston	活塞
Allow	35	Allow	allow	允许方块
Deny	36	Deny	deny	拒绝方块
Netherwart	37	Netherwart	nether_wart	下界疣
StoneDecoration	38	StoneDecoration	stone_decoration	石质装饰物
Bubble	39	Bubble	bubble	气泡柱
Egg	40	Egg	egg	龙蛋
SoftEgg	41	SoftEgg	—	软质蛋
Barrier	42	Barrier	barrier	屏障
DecorationFlammable	—	DecorationFlammable	decoration_flammable	可燃装饰物
Coral	43	Coral	—	珊瑚
DecorationSolid	44	DecorationSolid	—	固体装饰物
Dripstone	45	Dripstone	—	滴水石锥
ReinforcedStone	46	ReinforcedStone	—	强化石头
Sculk	47	Sculk	—	幽匿
SculkVein	48	SculkVein	—	幽匿脉络
ClientRequestPlaceholder	49	ClientRequestPlaceholder	—	客户端请求占位符
StructureVoid	50	StructureVoid	—	结构空位
Root	51	Root	—	菌索
SurfaceTypeTotal	52	SurfaceTypeTotal	surface_type_total	表面类型总数
Any	53	Any	—	任意

标签

主条目：方块/标签

地图颜色

ID	颜色	RGB	对应方块

形状

方块/形状

渲染方法

方块/渲染方法

技术性方块

方块/技术性方块

漏洞

关于“方块”的漏洞在国际版中由漏洞追踪器维护，请在此报告漏洞。

你知道吗

• 特定的方块可能在使用正常手段不能放置的有效位置里。例如，通过/setblock在空中放置告示牌，在地图更新时它仍然在那个位置，直至其被破坏，或在它下面放置方块及其下方的方块被破坏。

参见

• 数据值
• 透明度
• 亮度
• 物品
• 矿石
• 结构
• 海拔高度
• 挖掘

参考

游戏内容

参见：Template:Gameplay/content [编辑]