方块

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

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

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

行为

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

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

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

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

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

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

相关文件

方块/相关文件

相关组件

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

描述

用于确定如何解析并初始化此方块。

类型	名称	默认值	描述
布尔值	is_experimental	false	设置该方块是否为实验性的。实验性方块只能通过实验性玩法获得。
字符串	identifier	无	设置此方块的赋命名空间标识符。
对象	properties	无	自定义此方块的属性。

组件

基础组件

名称	描述
minecraft:aim_collision	设置方块的击中箱。
minecraft:block_light_emission	设置方块发出的光照强度。
minecraft:breathability	设置该方块的透气性，以及是否将其视为固体或空气的属性。
minecraft:collision_box	设置方块的碰撞箱。
minecraft:crafting_table	设置与方块互动时打开一个合成界面。
minecraft:creative_category	注册方块到创造模式物品栏及其分组。
minecraft:destroy_time	设置方块破坏所需时间。
minecraft:display_name	设置方块物品显示的悬浮文本。
minecraft:explosion_resistance	设置方块的爆炸抗性。
minecraft:flammable	设置方块的可燃性。
minecraft:friction	设置方块的摩擦力。
minecraft:geometry	设置方块模型。
minecraft:light_dampening	设置方块减弱的光照强度。
minecraft:loot	设置方块的掉落物。
minecraft:map_color	设置方块在地图上显示的颜色。
minecraft:material_instances	将模型文件中的面或渲染映射到实际的纹理。
minecraft:part_visibility	设置方块在指定条件下显示部分模型。
minecraft:placement_filter	设置方块被放置时应满足的条件。
minecraft:random_ticking	随机刻计时器。
minecraft:rotation	设置方块围绕方块中心的旋转角度。
minecraft:ticking	计划刻计时器。
minecraft:unit_cube	设置方块为单位方块。
minecraft:unwalkable	设置该方块是否不能被越过。

事件响应

名称	描述
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	将一个物品转换为另一个物品。

触发器

名称	描述
minecraft:on_fall_on	设置活动对象摔落到该方块上时执行的事件。
minecraft:on_interact	设置玩家与该方块互动（例如右键点击）时执行的事件。
minecraft:on_placed	设置该方块被放置时执行的事件。
minecraft:on_player_destroyed	设置玩家破坏该方块时执行的事件。
minecraft:on_player_placing	设置玩家放置该方块时执行的事件。
minecraft:on_step_on	当玩家踩上该方块时执行的事件。
minecraft:on_step_off	当玩家离开该方块时执行的事件。

方块列表

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

材料

方块材料枚举

键名	值	接口字符串	描述
Air	0	Air	空气
Dirt	1	Dirt	泥土
Wood	2	Wood	木质
Stone	3	Stone	石质
Metal	4	Metal	金属
Water	5	Water	水
Lava	6	Lava	熔岩
Leaves	7	Leaves	树叶
Plant	8	Plant	植物
SolidPlant	9	SolidPlant	固体植物
ReplaceablePlant	10	ReplaceablePlant	可替换植物
Sponge	11	Sponge	海绵
Cloth	12	Cloth	纺织品
Bed	13	Bed	床
Fire	14	Fire	火
Sand	15	Sand	沙质
Decoration	16	Decoration	装饰物
Glass	17	Glass	玻璃
Explosive	18	Explosive	易爆品
Ice	19	Ice	冰
PackedIce	20	PackedIce	浮冰
TopSnow	21	TopSnow	雪
Snow	22	Snow	雪块
PowderSnow	23	PowderSnow	细雪
Amethyst	24	Amethyst	紫水晶
Cactus	25	Cactus	仙人掌
Clay	26	Clay	黏土
Vegetable	27	Vegetable	蔬类
Portal	28	Portal	传送门
Cake	29	Cake	蛋糕
Web	30	Web	蜘蛛网
RedstoneWire	31	RedstoneWire	红石线
Carpet	32	Carpet	地毯
BuildableGlass	33	BuildableGlass	可建筑玻璃
Slime	34	Slime	粘液块
Piston	35	Piston	活塞
Allow	36	Allow	允许方块
Deny	37	Deny	拒绝方块
Netherwart	38	Netherwart	下界疣
StoneDecoration	39	StoneDecoration	石质装饰物
Bubble	40	Bubble	气泡柱
Egg	41	Egg	龙蛋
SoftEgg	42	SoftEgg	软蛋
Barrier	43	Barrier	屏障
DecorationFlammable	44	DecorationFlammable	可灼伤装饰物
Coral	45	Coral	珊瑚
DecorationSolid	46	DecorationSolid	固体装饰物
Dripstone	47	Dripstone	滴水石锥
ReinforcedStone	48	ReinforcedStone	强化石头
Sculk	49	Sculk	幽匿
SculkVein	50	SculkVein	幽匿脉络
ClientRequestPlaceholder	51	ClientRequestPlaceholder	客户端请求占位符
StructureVoid	52	StructureVoid	结构空位
Root	53	Root	根
SurfaceTypeTotal	54	SurfaceTypeTotal	总表面类型
Any	55	Any	任意

标签

主条目：方块/标签

地图颜色

ID	颜色	RGB	对应方块

形状

方块形状枚举

键名	值	接口字符串	原版使用
INVISIBLE	-1	invisible	不渲染（活塞臂、推动中的方块、隐形基岩、旗帜）
BLOCK	0	block	标准正方体（长方体）
CROSS_TEXTURE	1	cross_texture	单格草、花（树苗、蜘蛛网、甘蔗、蘑菇、枯死的灌木）
TORCH	2	torch	火把
FIRE	3	fire	火
WATER	4	water	流体（水、岩浆）
RED_DUST	5	red_dust	红石粉
ROWS	6	rows	作物（小麦、胡萝卜、马铃薯、甜菜、下界疣）
DOOR	7	door	门（铁门）
LADDER	8	ladder	梯子
RAIL	9	rail	铁轨
STAIRS	10	stairs	楼梯
FENCE	11	fence	栏杆
LEVER	12	lever	拉杆
CACTUS	13	cactus	仙人掌
BED	14	bed	床
DIODE	15	diode
	16		不再使用
	17		不再使用
IRON_FENCE	18	iron_fence	铁栏杆
STEM	19	stem	梗（南瓜梗、西瓜梗）
VINE	20	vine	藤蔓
FENCE_GATE	21	fence_gate	栏杆门
CHEST	22	chest	箱子
LILYPAD	23	lilypad	睡莲
	24		不再使用
BREWING_STAND	25	brewing_stand	酿造台
PORTAL_FRAME	26	portal_frame	末地传送门框架
	27		不再使用
COCOA	28	cocoa	可可果
	29		不再使用
	30		不再使用
TREE	31	tree	原木（干草块、石英、紫珀块、骨块）
WALL	32	cobblestone_wall	石墙（圆石墙、苔石墙）
	33		不再使用
	34		不再使用
	35		不再使用
	36		不再使用
	37		不再使用
	38		不再使用
	39		不再使用
DOUBLE_PLANT	40	double_plant	向日葵
	41		不再使用
FLOWER_POT	42	flower_pot	花盆
ANVIL	43	anvil	铁砧
DRAGON_EGG	44	dragon_egg	龙蛋
	45		不再使用
	46		不再使用
	47		不再使用
STRUCTURE_VOID	48	structure_void	结构空位
	49		不再使用
	50		不再使用
	51		不再使用
	52		不再使用
	53		不再使用
	54		不再使用
	55		不再使用
	56		不再使用
	57		不再使用
	58		不再使用
	59		不再使用
	60		不再使用
	61		不再使用
	62		不再使用
	63		不再使用
	64		不再使用
CROSS_TEXTURE_POLY	65	cross_texture_poly	不再使用
DOUBLE_PLANT_POLY	66	double_plant_poly	不再使用
BLOCK_HALF	67	block_half	台阶（附魔台）
TOP_SNOW	68	top_snow	雪片
TRIPWIRE	69	tripwire	拌线
TRIPWIRE_HOOK	70	tripwire_hook	拌线钩
CAULDRON	71	cauldron	炼药锅（熔岩炼药锅）
REPEATER	72	repeater	中继器
COMPARATOR	73	comparator	比较器
HOPPER	74	hopper	漏斗
SLIME_BLOCK	75	slime_block	粘液块（加热块）
PISTON	76	piston	活塞
BEACON	77	beacon	信标
CHORUS_PLANT	78	chorus_plant	紫颂植物
CHORUS_FLOWER	79	chorus_flower	紫颂花
END_PORTAL	80	end_portal	末地传送门方块
END_ROD	81	end_rod	末地烛
END_GATEWAY	82	end_gateway	不再使用
SKULL	83	skull	头颅
FACING_BLOCK	84	facing_block	侦测器、木桶、织布机、拼图方块
COMMAND_BLOCK	85	command_block	命令方块
TERRACOTTA	86	terracotta	黏土
DOUBLE_SIDE_FENCE	87	double_side_fence	玻璃板
ITEM_FRAME	88	frame	物品展示框
SHULKER_BOX	89	shulker_box	潜影盒
DOUBLESIDED_CROSS_TEXTURE	90	doublesided_cross_texture
DOUBLESIDED_DOUBLE_PLANT	91	doublesided_double_plant
DOUBLESIDED_ROWS	92	doublesided_rows
ELEMENT_BLOCK	93	element_block	元素
CHEMISTRY_TABLE	94	chemistry_table	化合物创建器
GLOW_STICK	95	glow_stick	不再使用
CORAL_FAN	96	coral_fan	珊瑚扇
SEAGRASS	97	seagrass	海草
KELP	98	kelp	海带
TRAPDOOR	99	trapdoor	活板门
SEA_PICKLE	100	sea_pickle	海泡菜
CONDUIT	101	conduit	潮涌核心
TURTLE_EGG	102	turtle_egg	海龟蛋
	103		不再使用
	104		不再使用
BUBBLE_COLUMN	105	bubble_column	气泡柱
BARRIER	106	barrier	屏障
SIGN	107	sign	木牌（墙上木牌）
BAMBOO	108	bamboo	竹子
BAMBOO_SAPLING	109	bamboo_sapling	竹笋
SCAFFOLDING	110	scaffolding	脚手架
GRINDSTONE	111	grindstone	砂轮
BELL	112	bell	钟
LANTERN	113	lantern	海晶灯
CAMPFIRE	114	campfire	营火
LECTERN	115	lectern	讲台
SWEET_BERRY_BUSH	116	sweet_berry_bush	甜浆果丛
CARTOGRAPHY_TABLE	117	cartography_table	制图台
COMPOSTER	118	composter	不再使用
STONE_CUTTER	119	stonecutter_block	切石机
HONEY_BLOCK	120	honey_block	不再使用
WEEPING_VINE	121		不再使用
TWISTING_VINE	122		不再使用
CHAIN	123	chain	锁链
	124		不再使用
SCULK_SENSOR	125	sculk_sensor	幽匿感测体
	126		不再使用
	127		不再使用
	128		不再使用
	129		不再使用
	130		不再使用
	131		不再使用
AZALEA FLOWERING_AZALEA	132	azalea flowering_azalea	杜鹃花丛、盛开的杜鹃花丛
GLOW_FRAME	133	glow_frame	荧光物品展示框
GLOW_LICHEN SCULK_VEIN	134	glow_lichen sculk_vein	发光地衣、幽匿脉络
	135		不再使用
	136		不再使用
	137		不再使用
SCULK_SHRIEKER	138	sculk_shrieker	幽匿尖啸体
NETEASE_MICRO_BLOCK	998	micro_block	微缩方块‌ ‌[仅中国版]

渲染方法

下表列出了原版方块的所有渲染方法。

方块渲染图层枚举

键名	值（国际版 & 中国版服务端）	值（中国版客户端）	接口字符串	描述
RENDERLAYER_DOUBLE_SIDED	0	0	double_sided	相当于没有背面消隐的blend。
RENDERLAYER_BLEND_WATER	不存在	1	—
RENDERLAYER_ALPHATEST_MICRO_BLOCK	不存在	2	—
RENDERLAYER_RAY_TRACED_WATER	1	3	—	光线追踪状态下的水。
RENDERLAYER_BLEND	2	4	blend	该渲染方式允许有透明像素或半透明像素（略微透明的像素，类似于染色玻璃），且不会启用环境光遮蔽，因此在制作不完整方块时可使用该渲染方式，防止出现丑陋的阴影。
RENDERLAYER_OPAQUE	3	5	opaque	用于渲染没有alpha通道的纹理，不允许有透明像素或半透明像素（会渲染为黑色或TGA基色）。该渲染方式会启用环境光遮蔽，从而在周围或下方形成阴影。比如常规的不透明方块或原版中处于内层的树叶。
RENDERLAYER_OPTIONAL_ALPHATEST	4	6	—	用于渲染可选透明像素，类似于原版中处于外层的树叶。
RENDERLAYER_ALPHATEST	5	7	alpha_test	该渲染方式仅允许透明像素或不透明像素，不允许半透明像素（类似于未染色的玻璃），且不会启用环境光遮蔽，因此在制作不完整方块时可使用该渲染方式，防止出现丑陋的阴影。
RENDERLAYER_SEASONS_OPAQUE	6	8	—	该渲染方式用于渲染在雪原的下雪天气下会变白色的不透明像素，类似于原版中可下雪生物群系中处于内层的树叶。
RENDERLAYER_SEASONS_OPTIONAL_ALPHATEST	7	9	—	该渲染方式用于渲染在雪原的下雪天气下会变白色的可选透明像素，类似于原版中可下雪生物群系中处于外层的树叶。
RENDERLAYER_ALPHATEST_SINGLE_SIDE	8	10	—
RENDERLAYER_ENDPORTAL	9	11	—
RENDERLAYER_BARRIER	10	12	—
RENDERLAYER_STRUCTURE_VOID	11	13	—

技术性方块

技术性方块是和其他方块的使用有着密切联系的方块。它们不能通过正常游戏获得，且大部分都不能通过命令获得，但是可以通过使用物品栏的编辑器获得。它们被游戏中的各种事件所引用。如果玩家获得技术性方块，它们的纹理通常是数据更新方块的纹理。

很多这些方块对应了其他物品；打火石用于放置火，水和熔岩可以用相对应的桶放置，床、门、蛋糕和花盆之类的方块有单独的物品。

ID	名称	赋命名空间标识符	数据值

漏洞

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

你知道吗

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

参见

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

参考

游戏内容

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