方块

来自Minecraft基岩版开发Wiki
Miemie Method（留言 | 贡献）2022年7月31日 (日) 02:47的版本 （文本替换 - 替换“方块/形状”为“方块/BlockShape”）
  本条目介绍的是方块开发信息。关于自定义方块教程，请见“Manual:方块”。
  关于更多信息，请见“Minecraft Wiki:方块”。

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

行为

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

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

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

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

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

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

相关文件

方块/相关文件

相关组件

主页面：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 对应方块

形状

方块形状枚举
键名 值 接口字符串 原版使用
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
UNUSED_16 16 不再使用
UNUSED_17 17 不再使用
IRON_FENCE 18 iron_fence 铁栏杆
STEM 19 stem 梗（南瓜梗、西瓜梗）
VINE 20 vine 藤蔓
FENCE_GATE 21 fence_gate 栏杆门
CHEST 22 chest 箱子
LILYPAD 23 lilypad 睡莲
UNUSED_24 24 不再使用
BREWING_STAND 25 brewing_stand 酿造台
PORTAL_FRAME 26 portal_frame 末地传送门框架
UNUSED_27 27 不再使用
COCOA 28 cocoa 可可果
UNUSED_29 29 不再使用
UNUSED_30 30 不再使用
TREE 31 tree 原木（干草块、石英、紫珀块、骨块）
WALL 32 cobblestone_wall 石墙（圆石墙、苔石墙）
UNUSED_33 33 不再使用
UNUSED_34 34 不再使用
UNUSED_35 35 不再使用
UNUSED_36 36 不再使用
UNUSED_37 37 不再使用
UNUSED_38 38 不再使用
UNUSED_39 39 不再使用
DOUBLE_PLANT 40 double_plant 向日葵
UNUSED_41 41 不再使用
FLOWER_POT 42 flower_pot 花盆
ANVIL 43 anvil 铁砧
DRAGON_EGG 44 dragon_egg 龙蛋
UNUSED_45 45 不再使用
UNUSED_46 46 不再使用
UNUSED_47 47 不再使用
STRUCTURE_VOID 48 structure_void 结构空位
UNUSED_49 49 不再使用
UNUSED_50 50 不再使用
UNUSED_51 51 不再使用
UNUSED_52 52 不再使用
UNUSED_53 53 不再使用
UNUSED_54 54 不再使用
UNUSED_55 55 不再使用
UNUSED_56 56 不再使用
UNUSED_57 57 不再使用
UNUSED_58 58 不再使用
UNUSED_59 59 不再使用
UNUSED_60 60 不再使用
UNUSED_61 61 不再使用
UNUSED_62 62 不再使用
UNUSED_63 63 不再使用
UNUSED_64 64 不再使用
UNUSED_65
CROSS_TEXTURE_POLY‌[不再使用]		 65 cross_texture_poly‌[不再使用] 不再使用
UNUSED_66
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 化合物创建器
UNUSED_95
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 海龟蛋
UNUSED_103 103 不再使用
UNUSED_104 104 不再使用
BUBBLE_COLUMN 105 bubble_column 气泡柱
BARRIER‌[不再使用]
CAMERA_FACING_SPRITE		 106 barrier
camera_facing_sprite		 屏障、相机面向精灵图
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 锁链
DRIED_KELP_BLOCK 124 干海带块
SCULK_SENSOR 125 sculk_sensor 幽匿感测体
POINTED_DRIPSTONE 126 滴水石锥
LIGHTNING_ROD 127 避雷针
SPORE_BLOSSOM 128 孢子花
CAVE_VINE 129 洞穴藤
BIG_DRIPLEAF 130 大型垂滴叶
SMALL_DRIPLEAF 131 小型垂滴叶
AZALEA 132 azalea
flowering_azalea		 杜鹃花丛、盛开的杜鹃花丛
GLOW_ITEM_FRAME 133 glow_frame 荧光物品展示框
MULTIFACE_BLOCK 134 glow_lichen
sculk_vein		 发光地衣、幽匿脉络
AMETHYST_CLUSTER 135 紫水晶簇
CANDLE 136 蜡烛
CANDLE_CAKE 137 插上蜡烛的蛋糕
SCULK_SHRIEKER 138 sculk_shrieker 幽匿尖啸体
CLIENT_REQUEST_PLACEHOLDER 139 客户端请求占位符
FROG_SPAWN 140 青蛙卵
MANGROVE_PROPAGULE 141 红树胎生苗
MANGROVE_ROOT 142 红树根
BAMBOO_BLOCK 143 竹块
CHISELED_BOOKSHELF 144 雕纹书架
DECORATED_POT 145 饰纹陶罐
PINK_PETALS 146 粉红色花簇
CALIBRATED_SCULK_SENSOR 147 校频幽匿感测体
PITCHER_CROP 148 瓶子草植株
PITCHER_PLANT 149 瓶子草
SNIFFER_EGG 150 嗅探兽蛋
NETEASE_MICRO_BLOCK 998 micro_block 微缩方块‌ ‌[仅中国版]
NETEASE_BLOCK_ACTOR 998 netease_block_actor 具有方块实体的方块‌ ‌[仅中国版]

渲染方法

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

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

技术性方块

方块/技术性方块

存储格式

Manual:存档格式/方块

历史

漏洞

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

你知道吗

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

画廊

参见

参考

  1. ↑ https://minecraft.fandom.com/zh/wiki/%E6%96%B9%E5%9D%97

游戏内容

参见：Template:Gameplay/content [编辑]
方块
取自“https://wiki.mcbe-dev.net/w/index.php?title=方块&oldid=17928”