方块状态

  本文章介绍的是方块状态的定义。关于定义方块模型的文件，请见“方块模型#方块状态”。

方块状态（Block states）是进一步定义一个方块所需的附加数据。

方块状态列表

铁砧

名称	值	描述
damage	0	铁砧
	1	轻微受损的铁砧
	2	受损严重的铁砧
facing	north south east west	指示铁砧是朝北向南放置的还是朝南向北放置的。 指示铁砧是朝西向东放置的还是朝东向西放置的。 该值与玩家放置铁砧时的朝向顺时针旋转了90°。

旗帜

站立

名称	值	描述
rotation	0—15	该方块所面对的方向: 0：南 1：西南偏南 2：西南 3：西南偏西 4：西 5：西北偏西 6：西北 7：西北偏北 8：北 9：东北偏北 10：东北 11：东北偏东 12：东 13：东南偏东 14：东南 15：东南偏南
waterlogged	true false	在此告示牌的同一位置是否有水。

依附方块

名称	值	描述
facing	north south east west	方块朝向的方向。例如，一个依附着它西边的方块，其朝向的方向为东边。 与玩家放置方块时的朝向相反。
waterlogged	true false	在此告示牌的同一位置是否有水。

床

名称	值	描述
facing	north south east west	床的头部所指向的方向。 同样也是玩家放置床时所面对的方向。
occupied	true false	如果为是(true)，则有玩家在使用这张床。
part	head foot	表示在当前方块中是床的哪一个部分。

甜菜根

名称	值	描述
age	0
	1
	2
	3	完全成熟。

骨块

名称	值	描述
axis	x	骨块呈东-西方向。
	y	骨块呈垂直方向。
	z	骨块呈南-北方向。

酿造台

名称	值	描述
has_bottle_0	true false	当为true时第一个槽放有药水。
has_bottle_1	true false	当为true时第二个槽放有药水。
has_bottle_2	true false	当为true时第三个槽放有药水。

按钮

minecraft:stone_button

minecraft:wooden_button

名称	值	描述
face	floor ceiling wall	方块放置的朝向。 Floor是方块的顶部，Ceiling是方块的底部，wall是方块的侧面。
facing	north south east west	从按钮附着的方块到按钮的方向。 与玩家放置按钮时玩家的朝向相反。
powered	true false	如果按钮目前是激活的，则为True。

仙人掌

名称	值	描述
age	0–15	刚种下的和刚生长出的仙人掌都有为0的age。 这项age会在随机的间歇中增加。 在age为15时，仙人掌会尝试在其上方生长很多仙人掌。

蛋糕

名称	值	描述
bites	0–6	蛋糕被吃掉的片数。

地毯

名称	值	描述
color	white
	orange
	magenta
	light_blue
	yellow
	lime
	pink
	gray
	silver	“silver”指的是淡灰色。
	cyan
	purple
	blue
	brown
	green
	red
	black

胡萝卜

名称	值	描述
age	0–1
	2–3
	4–6
	7	已经完全成熟

炼药锅

名称	值	描述
level	0–3	炼药锅里的水位等级，0为空，3为满。

箱子，末影箱和陷阱箱

名称	值	描述
facing	north south east west	箱子门闩的朝向。这个方向由玩家放置箱子时的方向决定。
type	single left right	箱子连接的方向。
waterlogged	true false	在此箱子的同一位置是否有水。

紫颂花

名称	值	描述
age	0–4	紫颂花的age从0开始。当水平生长时和/或额外长出一朵紫颂花时增加。
	5	当age为5时，紫颂花不再生长。紫颂花的age可以在任何时候变成5。

紫颂植物

名称	值	描述
north  south  east  west  up  down	true false	当值为true时，紫颂植物向这个方向连接。

圆石墙和苔石墙

名称	值	描述
east	false true	当值为true, 圆石墙会从中心向东延伸。
north	false true	当值为true, 圆石墙会从中心向北延伸。
south	false true	当值为true, 圆石墙会从中心向南延伸。
up	false true	当值为true, 圆石墙会从中心向上延伸。
waterlogged	false true	在此墙的同一位置是否有水。
west	false true	当值为true, 圆石墙会从中心向西延伸。

可可果

名称	值	描述
age	0–2	可可果的生长阶段，2是完全成熟。
facing	north south east west	可可果连接木头的方向。 是玩家放置可可果时的朝向。

命令方块

名称	值	描述
triggered (在1.9中移除)	true false	当命令方块已经在上一次激活了当前命令时为真。
conditional (1.9)	true false	当命令方块为条件制约模式为真
facing (1.9)	north south east west up down	命令方块的指向

混凝土

名称	值	描述
color	white
	orange
	magenta
	light_blue
	yellow
	lime
	pink
	gray
	silver	“银色”指的是浅灰色。
	cyan
	purple
	blue
	brown
	green
	red
	black

混凝土粉末

名称	值	描述
color	white
	orange
	magenta
	light_blue
	yellow
	lime
	pink
	gray
	silver	“银色”指的是浅灰色。
	cyan
	purple
	blue
	brown
	green
	red
	black

阳光传感器

minecraft:daylight_detector

minecraft:daylight_detector_inverted

名称	值	描述
power	0–15	通过阳光传感器产生的红石信号强度水平。

发射器

名称	值	描述
facing	north south east west up down	发射器发射口的一面所朝的方向。 是玩家放置发射器时的朝向的反方向。
triggered	true false	当发射器被激活时为true。

门

minecraft:wooden_door

minecraft:iron_door

minecraft:spruce_door

minecraft:birch_door

minecraft:jungle_door

minecraft:acacia_door

minecraft:dark_oak_door

名称	值	描述
facing	north south east west	门“里面”的朝向。 方向为玩家放置门时面对的方向。 例如，朝向东方放置门将会导致在门关闭的时候朝向西方。
half	upper lower	识别是门的哪一部分。
hinge	left right	识别门轴在哪一边（与门里面的朝向相同）
open	true false	如果门当前已开启，则为 True（可能与 powered 不同）。
powered	true false	如果门当前已被激活则为 True（可能与 open 不同）。

投掷器

名称	值	描述
facing	north south east west up down	投掷器发射的一面朝向的方向。 是玩家放置投掷器时的朝向的反方向。
triggered	true false	当投掷器被激活时为true。

末地传送门框架

名称	值	描述
eye	true false	如果是true，末地传送门框架包含一个末影之眼。
facing	north south east west	末地传送门框架的朝向。这个方向由玩家放置末地传送门框架时的方向决定。 自然生成的末地传送门框架所有都会朝向里面。

末地烛

名称	值	描述
facing	north south east west up down	末地烛附着方块的方向。 当玩家放置末地烛时，末地烛朝向玩家所面向的方向的相反方向。

耕地

名称	值	描述
moisture	0–6	未完全湿润。
	7	完全湿润。

栅栏

minecraft:fence

minecraft:spruce_fence

minecraft:birch_fence

minecraft:jungle_fence

minecraft:acacia_fence

minecraft:dark_oak_fence

minecraft:nether_brick_fence

名称	值	描述
north  south  east  west	true false	数值为true时，栅栏将从中心柱向这个方向延伸。
waterlogged	true false	在此栅栏的同一位置是否有水。

栅栏门

minecraft:fence_gate

minecraft:spruce_fence_gate

minecraft:birch_fence_gate

minecraft:jungle_fence_gate

minecraft:acacia_fence_gate

minecraft:dark_oak_fence_gate

名称	值	描述
facing	north south east west	对于一个打开的栅栏门，是这个栅栏门的打开方向 对于一个关闭的栅栏门,是玩家放置这个栅栏门时的方向, 或者是它最后一次打开的方向。
in_wall	true false	如果为true, 这个栅栏门被降低了三个像素, 使其更贴合圆石墙和苔石墙的高度。
open	true false	如果为true，这个栅栏门是打开的。
powered	true false	如果为true，这个栅栏门接收到了红石信号。

火

名称	值	描述
age	0—15	新放置的火的age值为0。在每个方块刻里，有1⁄3的几率增加这个值。 这个字段将影响火熄灭的方式。
up	true false	在上表面显示的火的材质。 在正常游戏里，这在火上面有一个方块，且其下面没有方块时发生。
north  south  east  west	true false	若为 true，火的材质会在方块的一个表面显示。 在正常游戏里，这在特定的方向有可燃方块时发生。

花

向日葵, 欧丁香, 玫瑰丛 和 牡丹

名称	值	描述
half	upper lower	该植物的半个部分。

霜冰

名称	值	描述
age	0	新生成的霜冰。
	1–3	霜冰出现裂纹。

熔炉

minecraft:furnace

minecraft:lit_furnace

名称	值	描述
facing	north south east west	熔炉开口面向的方向。 是玩家放置熔炉时的朝向的反方向。

玻璃板

名称	值	描述
north  south  east  west	true false	当玻璃板与其他玻璃板、染色玻璃板或方块连接时，指定玻璃板要从其中心所延伸的方向。
waterlogged	true false	在此玻璃板的同一位置是否有水。

带釉陶瓦

名称	值	描述
facing	north south east west	放置方块时与玩家视野方向相对的一面。

草丛

高草丛（tall_grass）和大型蕨（large_fern）

名称	值	描述
half	upper lower	方块的半个部分。

草方块

名称	值	描述
snowy	true false	若为true，方块的顶部和侧面将会使用有雪的材质。 游戏中当方块顶部被雪或雪块覆盖时为true。

干草块

名称	值	描述
axis	x	干草块的干草以东西向放置
	y	干草块的干草以纵向放置
	z	干草块的干草以南北向放置

漏斗

名称	值	描述
enabled	true false	如果是true，漏斗则可以从它的物品栏中移动物品。 如果接收到红石信号，则为false。
facing	north south east west down	漏斗的输出方向。 漏斗将只会把物品注入这个方向的容器。

铁栏杆

名称	值	描述
north  south  east  west	true false	如果为true，该铁栏杆从它的中心向这个方向延伸。
waterlogged	true false	在此铁栏杆的同一位置是否有水。

南瓜灯

名称	值	描述
facing	north south east west	南瓜灯有雕刻的一面朝向的方向。 是玩家放置南瓜灯时的朝向的反方向。

唱片机

名称	值	描述
has_record	true false	当唱片机内有唱片时为true。

梯子

名称	值	描述
facing	north south east west	梯子附着的方块朝梯子的方向。
waterlogged	true false	在此梯子的同一位置是否有水。

熔岩

名称	值	描述
level	0	熔岩源方块。
	1–7	熔岩的高度，1是最高的。 也代表熔岩。在主世界只使用了2、4和6。
	8–15	掉落的熔岩。 该级别在8及以上时表示其上面没有掉落的熔岩。 一个级别2的熔岩实例将会其下方生成级别10的熔岩。 级别的区别不会对熔岩的行为造成影响。

树叶

minecraft:leaves

名称	值	描述
distance	1 2 3 4 5 6 7	此树叶方块距合适的原木类型方块的距离。
persistent	true false	树叶方块是否一直保持，不考虑原木方块的缺少。

拉杆

名称	值	描述
facing	north south east west	拉杆附着的方块的面。 为拉杆附着的方块的面的方向。 例如，一个放置在朝向南的墙壁的拉杆将会朝向“南”。
	up_x	附着在地板上的拉杆关闭时朝向东。
	down_x	附着在天花板上的拉杆关闭时朝向东。
	up_z	附着在地板上的拉杆关闭时朝向南。
	down_z	附着在天花板上的拉杆关闭时朝向南。
powered	true false	拉杆“开启”时为True，并提供红石信号。

西瓜梗

名称	值	描述
age	0	新种下的西瓜梗
	1–6	西瓜梗当前生长阶段。
	7	西瓜梗已成熟，可以生成西瓜。
facing	north south east west	西瓜梗朝向西瓜的方向。 在各个方向的西瓜梗的颜色由生长阶段决定，但不是由其高度决定。
	up	表示西瓜梗是否没有连接到西瓜。 西瓜梗的高度和颜色和朝向取决于生长阶段。

怪物蛋

名称	值	描述
variant	stone	石头怪物蛋
	cobblestone	圆石怪物蛋
	stone_brick	石砖怪物蛋
	mossy_brick	苔石石砖怪物蛋
	cracked_brick	裂石砖怪物蛋
	chiseled_brick	錾制石砖怪物蛋

蘑菇方块

minecraft:brown_mushroom_block

minecraft:red_mushroom_block

名称	值	描述
east  west  north  south  up  down	false true	如果为true，此面使用蘑菇盖 或梗 的材质。 否则使用气孔 材质。

地狱疣

名称	值	描述
age	0
	1–2
	3	完全生长

活塞和粘性活塞

名称	值	描述
extended	true false	在活塞伸出的情况下为true。
facing	north south east west up down	活塞臂指向的方向。 这个方向在玩家放置的时候对着玩家。

minecraft:piston_head

名称	值	描述
facing	north south east west	活塞臂指向方向。
short	true false	若为 true，活塞臂将会比平常时候要短，为4像素。
type	normal sticky	活塞臂类型。

minecraft:piston_extension

名称	值	描述
extended	true false	如果为true，方块会被活塞推动。
facing	north south east west up down	方块被活塞推动的方向。

下界传送门方块

名称	值	描述
axis	x	传送门方块朝向东-西。
	z	传送门方块朝向北-南。

侦测器

名称	值	描述
facing	north south east west up down	侦测器的朝向。 与玩家放置方块时的朝向相反。
power	true false	当侦测器观察到变化并输出红石信号时为true。

马铃薯

名称	值	描述
age	0–1
	2–3
	4–6
	7	完全生长。

压力板

minecraft:stone_pressure_plate

minecraft:wooden_pressure_plate

石质或木质压力板

名称	值	描述
powered	true false	如果压力板是下陷的，提供动力，那么为true。

测重压力板

名称	值	描述
power	0—15	指定当前由测重压力板产生的红石信号强度。

南瓜

minecraft:pumpkin

名称	值	描述
facing	north south east west	南瓜有雕刻的一面朝向的方向。 是玩家放置南瓜时的朝向的反方向。

南瓜梗

名称	值	描述
age	0	新种下的南瓜梗。
	1–6	南瓜梗的生长阶段。
	7	已成熟的南瓜梗，将会生成南瓜。
facing	north south east west	南瓜梗朝向南瓜的方向。
	up	表示 是否没有连接南瓜。

竖纹紫珀块

名称	值	描述
axis	x	竖纹紫珀块的纹理为东西走向。
	y	竖纹紫珀块的纹理为上下走向。
	z	竖纹紫珀块的纹理为南北走向。

石英块

名称	值	描述
variant	default	石英块
	chiseled	錾制石英块
	lines	竖纹石英块

铁轨

铁轨

名称	值	描述
shape	north_south east_west north_east north_west south_east south_west	指定铁轨连接到的两个方向。 例如，south_east的铁轨连接西南方向的弯铁轨。
	ascending_north ascending_south ascending_east ascending_west	铁轨会上升到值所指定的方向。 例如，ascending_west的铁轨是从东向西升高的直铁轨。

激活铁轨，探测铁轨和充能铁轨

名称	值	描述
powered	true false	如果铁轨被激活，则为True。
shape	north_south east_west	指定了铁轨的方向。
	ascending_north ascending_south ascending_east ascending_west	铁轨上坡所朝向的方向。 例如，一个值为ascending_west的铁轨是一段自东朝向西的上坡铁轨。

红石比较器

minecraft:powered_comparator

minecraft:unpowered_comparator

名称	值	描述
facing	north south east west	从比较器的“输出”侧到“输入”侧的方向， 即放置比较器时玩家背对的方向。
mode	compare subtract	指定红石比较器的当前模式。
powered	true false	如果红石比较器被激活，则为true。

红石粉

名称	值	描述
north（北）  south（南）  east（东）  west（西）	none	红石粉不会连接这个方向。
	side	红石粉水平连接这个方向。
	up	红石粉对角向上连接这个方向。
power	0–15	红石粉目前的充能等级。

红石中继器

minecraft:powered_repeater

minecraft:unpowered_repeater

名称	值	描述
delay	1 2 3 4	红石中继器延迟的红石刻数。
facing	east north south west	从红石中继器的“输出”侧到“输入”侧的方向。 与放置红石中继器时玩家的朝向相反。
locked	false true	如果中继器当前被锁存，则为true。
powered	false true	如果中继器当前激活，则为true。

红石火把和火把

名称	值	描述
facing	up north east south west	火把顶部的指向

树苗

名称	值	描述
stage	0 或 1	指定树苗的生长阶段。
type	oak	橡树树苗
	spruce	云杉树树苗
	birch	桦树树苗
	jungle	丛林树树苗
	acacia	金合欢树树苗
	dark_oak	深色橡树树苗

潜影盒

名称	值	描述
facing	north south east west up down	潜影盒朝向的方向。 放置潜影盒时玩家朝向的反方向。

告示牌

站立

名称	值	描述
rotation	0—15	该方块所面对的方向: 0：南 1：西南偏南 2：西南 3：西南偏西 4：西 5：西北偏西 6：西北 7：西北偏北 8：北 9：东北偏北 10：东北 11：东北偏东 12：东 13：东南偏东 14：东南 15：东南偏南
waterlogged	true false	在此告示牌的同一位置是否有水。

依附方块

名称	值	描述
facing	north south east west	方块朝向的方向。例如，一个依附着它西边的方块，其朝向的方向为东边。 与玩家放置方块时的朝向相反。
waterlogged	true false	在此告示牌的同一位置是否有水。

台阶

minecraft:stone_slab

名称	值	描述
type	top bottom	台阶在对应方块的位置。
	double	台阶是否为双层。
waterlogged	true false	在此台阶的同一位置是否有水。

雪

名称	值	描述
layers	1—8	The number of layers thick. Each layer adds two pixels to the block height, and each layer after the first adds two pixels to the collision box.

海绵

名称	值	描述
wet	true	湿海绵
	false	海绵

染色玻璃

名称	值	描述
color	white
	orange
	magenta
	light_blue
	yellow
	lime
	pink
	gray
	silver	“银色”指浅灰色。
	cyan
	purple
	blue
	brown
	green
	red
	black

染色玻璃板

名称	值	描述
color	white
	orange
	magenta
	light_blue
	yellow
	lime
	pink
	gray
	silver	'银色'指浅灰色。
	cyan
	purple
	blue
	brown
	green
	red
	black
north  south  east  west	true false	数值为true时，染色玻璃板将从中心柱向这个方向延伸。

楼梯

• minecraft:acacia_stairs
• minecraft:birch_stairs
• minecraft:brick_stairs
• minecraft:dark_oak_stairs
• minecraft:jungle_stairs
• minecraft:nether_brick_stairs
• minecraft:oak_stairs
• minecraft:quartz_stairs
• minecraft:red_sandstone_stairs
• minecraft:sandstone_stairs
• minecraft:spruce_stairs
• minecraft:stone_brick_stairs
• minecraft:stone_stairs

名称	值	描述
facing	north south east west	楼梯整格面的朝向。 当被玩家在游戏里放置时，这与玩家的朝向相同。
half	top bottom	如果楼梯是上下颠倒的则为 Top。
shape	straight inner_left inner_right outer_left outer_right	“straight”是默认的楼梯形状。 “inner”是“内角”楼梯形状，包括了2个整格和2个楼梯形的面。 “outer”是“外角”楼梯形状，包括了2个楼梯形和2个半格的面。 “left”和“right”指定了高的那一部分的方向。
waterlogged	true false	在此楼梯的同一位置是否有水。

石砖

名称	值	描述
variant	stonebrick	石砖
	mossy_stonebrick	苔石砖
	cracked_stonebrick	裂石砖
	chiseled_stonebrick	錾制石砖

结构方块

名称	值	描述
mode	save	保存结构方块
	load	加载结构方块
	corner	角落结构方块
	data	数据结构方块

甘蔗

名称	值	描述
age	0–15	刚种植的甘蔗—和一个上面刚生长了甘蔗的甘蔗—都有0的age。 age以随机间隔增加。 在age 15，甘蔗会尝试在它的上面生长甘蔗。

高草丛和花

minecraft:double_plant

名称	值	描述
half	upper lower	该方块的半个部分。
variant	sunflower	向日葵
	syringa	欧丁香
	double_grass	高草丛
	double_fern	大型蕨
	double_rose	玫瑰丛
	paeonia	牡丹
facing	north south east west	植物朝向的方向。目前这并未被游戏使用。 上半部分方块值总是“north”，而下半部分方块值总是“east”。

TNT

名称	值	描述
unstable	true	TNT能被玩家击打后点燃。
	false	普通的TNT表现。

活板门

minecraft:trapdoor

minecraft:iron_trapdoor

名称	值	描述
facing	north south east west	活板门打开的方向。 其依附方块的对边。
half	top bottom	活板门是在所依附方块的顶部还是底部。
open	true false	值为true时，活板门是打开的。（不同于powered）
powered	true false	值为true时，活板门是被充能的。（不同于open）
waterlogged	true false	在此活板门的同一位置是否有水。

绊线

名称	值	描述
attached	true false	如果绊线连接到有效的绊线钩，则为true。
disarmed	true false	如果绊线被拆除（即使用剪刀破坏），则为true。
north  south  east  west	true false	如果绊线在该方向连接，则为true。 例如，如果东、西和南为true，则绊线连接到这些方向上的绊线或绊线钩。
powered	true false	如果绊线被实体激活，则为true。

绊线钩

名称	值	描述
attached	true false	如果绊线钩被线有效地连接时，则为true
facing	north south east west	绊线钩从其附着的方块表面往外伸出的方向 例如，一个朝向北的绊线钩将附着在它南边的一个方块上。
powered	true false	如果绊线钩被激活，则为true

藤蔓

名称	值	描述
north  south  east  west  up	true false	若为true，会在指定的表面上显示藤蔓方块的藤蔓材质。

水

名称	值	描述
level	0	水源方块。
	1–7	水的高度，1为最高。 也用于区分到水源方块的距离或向下流的水方块。
	8–15	流下的水。 该级别等价于8加上它上方不在流下的水的级别之和。 级别2的水将会在其下方生成级别10的掉落的水。 级别的数值差异并不会对水的行为造成影响。

小麦

名称	值	描述
age	0
	1
	2
	3
	4
	5
	6
	7	成熟。

原木

名称	值	描述
axis	x	原木东西朝向。
	y	原木垂直朝向。
	z	原木南北朝向。

历史

Java版
1.8			14w11a		加入了方块状态。仅用于游戏引擎，并未在世界文件中使用或在命令中使用。
			14w26a		在代码中改为使用方块状态。
1.11			16w32a		现在可以在命令中使用方块状态了。