方块

From Minecraft基岩版开发Wiki

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

行为[edit]

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

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

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

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

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

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

相关文件[edit]

方块/相关文件

相关组件[edit]

描述[edit]

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

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

组件[edit]

基本组件[edit]

名称
描述
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 设置该方块是否不能被越过。

事件[edit]

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

触发器[edit]

名称
描述
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 当玩家离开该方块时执行的事件。

方块列表[edit]

材料[edit]

枚举键 接口字符串‌ ‌[仅附加包] 枚举值 原版用法
Air Air 0 空气
Dirt Dirt 1 泥土
Wood Wood 2 木质
Stone Stone 3 石质
Metal Metal 4 金属
Water Water 5
Lava Lava 6 熔岩
Leaves Leaves 7 树叶
Plant Plant 8 植物
ReplaceablePlant ReplaceablePlant 9 可替换植物
Sponge Sponge 10 海绵
Cloth Cloth 11 纺织品
Bed Bed 12
Fire Fire 13
Sand Sand 14 沙质
Decoration Decoration 15 装饰物
Glass Glass 16 玻璃
Explosive Explosive 17 易爆品
Ice Ice 18
PackedIce PackedIce 19 浮冰
TopSnow TopSnow 20
Snow Snow 21 雪块
PowderSnow PowderSnow 22 细雪
Amethyst Amethyst 23 紫水晶
Cactus Cactus 24 仙人掌
Clay Clay 25 黏土
Vegetable - 26
Portal - 27
Cake - 28
Web Web 29 蜘蛛网
RedstoneWire RedstoneWire 30 红石线
Carpet Carpet 31 地毯
BuildableGlass BuildableGlass 32 可建筑玻璃
Slime Slime 33 粘液块
Piston Piston 34 活塞
Allow Allow 35 允许方块
Deny Deny 36 拒绝方块
Netherwart Netherwart 37 下界疣
StoneDecoration StoneDecoration 38 石质装饰物
Bubble Bubble 39 气泡柱
Egg Egg 40 龙蛋
[需要更多信息] - 41
Barrier Barrier 42 屏障
DecorationFlammable DecorationFlammable 43 可灼伤装饰物
Coral Coral 44 珊瑚
DecorationSolid - 45 固体装饰物
[需要更多信息] - 46
Sculk Sculk 47 Sculk
[需要更多信息] - 48
[需要更多信息] - 49
SurfaceTypeTotal SurfaceTypeTotal 50 总表面类型
Any Any 51 任何表面类型

标签[edit]

地图颜色[edit]

ID 颜色 RGB 对应方块

形状[edit]

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

渲染方法[edit]

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

枚举键 接口字符串‌ ‌[仅附加包] 枚举值
描述
RENDERLAYER_DOUBLE_SIDED double_sided 0 本应相当于没有背面消隐的blend,但目前其功能与blend相同。
[需要更多信息] - 1 光线追踪状态下的水。
RENDERLAYER_BLEND blend 2 该渲染方式允许有透明像素或半透明像素(略微透明的像素,类似于染色玻璃),且不会启用环境光遮蔽,因此在制作不完整方块时可使用该渲染方式,防止出现丑陋的阴影。
RENDERLAYER_OPAQUE opaque 3 用于渲染没有alpha通道的纹理,不允许有透明像素或半透明像素(会渲染为黑色或TGA基色)。该渲染方式会启用环境光遮蔽,从而在周围或下方形成阴影。比如常规的不透明方块或原版中处于内层的树叶。
RENDERLAYER_OPTIONAL_ALPHATEST - 4 用于渲染可选透明像素,类似于原版中处于外层的树叶。
RENDERLAYER_ALPHATEST alpha_test 5 该渲染方式仅允许透明像素或不透明像素,不允许半透明像素(类似于未染色的玻璃),且不会启用环境光遮蔽,因此在制作不完整方块时可使用该渲染方式,防止出现丑陋的阴影。
RENDERLAYER_SEASONS_OPAQUE - 6 该渲染方式用于渲染在雪原的下雪天气下会变白色的不透明像素,类似于原版中可下雪生物群系中处于内层的树叶。
RENDERLAYER_SEASONS_OPTIONAL_ALPHATEST - 7 该渲染方式用于渲染在雪原的下雪天气下会变白色的可选透明像素,类似于原版中可下雪生物群系中处于外层的树叶。
RENDERLAYER_ALPHATEST_SINGLE_SIDE - 8
RENDERLAYER_ENDPORTAL - 9
RENDERLAYER_BARRIER - 10
RENDERLAYER_STRUCTURE_VOID - 11
_RENDERLAYER_COUNT - 12 总渲染图层数。

技术性方块[edit]

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

很多这些方块对应了其他物品;打火石用于放置熔岩可以用相对应的放置,蛋糕花盆之类的方块有单独的物品。

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

存储格式[edit]

Manual:存档格式/方块

历史[edit]

漏洞[edit]

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

你知道吗[edit]

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

画廊[edit]

参见[edit]

参考[edit]