# JSON组件

# format_version

基岩版自定义方块的json结构曾经过多次调整,当填写format_version时,需要按照对应版本的json结构编写components。

你可以在以下两个版本进行选择:

  • 1.16.0

    该版本的components结构详见bedrock.dev (opens new window)

  • 1.10.0

    该版本的components结构详见bedrock.dev (opens new window)。该版本相比于1.16.0,component的值为一个Json Object,例如minecraft:destroy_time,在1.10.0中为

    "minecraft:destroy_time": {
        "value": 4.0
    }
    

    而在更高的版本中为

    "minecraft:destroy_time": 4.0
    

# description

类型 默认值 解释
identifier str 包括命名空间及物品名。需要全局唯一。
建议使用mod名称作为命名空间
register_to_create_menu bool false 是否注册到创造栏
category str Nature 注册到创造栏的分类,可选的值有:
Construction
Nature
Equipment
Items

# components

目前行为包中自定义方块json中支持的component包括原版component和网易独有的component。minecraft开头的为原版component,netease开头的为网易独有component。

对于原版component,你可以在上方的format_version解释中找到更多的参数及解释。

# minecraft:loot

可用于使用loot table控制掉落物

可参考CustomBlocksMod的customblocks:customblocks_test_ore方块

# minecraft:max_stack_size

可用于设置方块物品最大堆叠数量,注意:该值不能超过64

# minecraft:destroy_time

可用于控制挖掘所需的时间。该值的含义与官方wiki (opens new window)的“硬度”一致

主要用于挖掘的功能

# minecraft:block_light_emission

可用于设置方块亮度。关于亮度及方块光源可参考官方wiki (opens new window)

主要用于亮度的功能

# minecraft:explosion_resistance

可用于设置爆炸抗性。原版方块的爆炸抗性见官方wiki (opens new window)

# minecraft:block_light_absorption

可用于设置方块的透光率。具体可参考官方wiki (opens new window)

默认为不透光。

主要用于亮度的功能

# minecraft:map_color

可用于设置方块显示在地图上的颜色

# netease:tier

用于设置与挖掘相关的属性

主要用于挖掘的功能

类型 默认值 解释
digger string 必须设置。表示方块使用此工具挖掘时有速度加成。
可选的值有:
shovel:铲
pickaxe:镐
hatchet:斧
hoe:锄
destroy_special bool false 可选。
当设置为true时,表示只有使用digger设置的工具进行挖掘才会产生掉落物。
level int 0 可选。
当destroy_special为true时才会生效。表示挖掘所需的工具等级,若手持工具等级小于该值,则不会产生掉落物。
原版工具的等级:
空手/其他非工具物品:0
木制/金制工具:0
石制工具:1
铁制工具:2
钻石工具:3

# netease:aabb

用于设置方块的碰撞盒

注意事项:

  1. 无碰撞箱的方块请将collision的每个项都设置为0
  2. 有碰撞箱的方块,clip的范围需要小于或等于collision的范围,否则弹射物命中时会异常
  3. aabb的min不要小于[-1, -1, -1],max不要大于[2, 2, 2]

可参考CustomBlocksMod的customblocks_model_flower及customblocks_model_wire方块。

类型 默认值 解释
collision object或array 计算与物体碰撞时用的碰撞盒
clip object或array 计算射线检测时用的碰撞盒。如准心选取及弹射物碰撞。
(那么当该AABB没有体积时,准心与弹射物都会无视这个方块)

当collision或clip为object时,用于表示恒定大小的单一碰撞盒,结构为:

类型 默认值 解释
min array(float) [0, 0, 0] min的三个值必须小于等于max的三个值
max array(float) [1, 1, 1]

当collision或clip为array时,用于可变化的多个碰撞盒的组合,通常用于可变化的自定义方块模型。元素的结构为:

类型 默认值 解释
enable molang true 控制是否开启该碰撞箱
目前仅支持is_connect查询,详见netease:connection
min array(float) [0, 0, 0] min的三个值必须小于等于max的三个值
max array(float) [1, 1, 1]

# netease:face_directional

用于设置方块的多面向

主要用于多面向的功能

类型 默认值 解释
type string direction:四面向方块
facing_direction:六面向方块

# netease:fuel

可燃类物品组件。允许该方块物品作为燃料在熔炉中燃烧

类型 默认值 解释
duration float 0 可填, 该物品可提供的熔炉燃烧时长(秒)。

# netease:render_layer

用于设置方块渲染时使用的材质

可参考CustomBlocksMod的customblocks:customblocks_model_flower方块。

类型 默认值 解释
value string 目前支持的材质有:
opaque:不透明,即“terrain_opaque”材质。默认为此项
alpha:全透明,即“terrain_alpha”材质,如火焰,该材质用于异形方块,用在方块类上但与其他方块重合时会出现闪烁,可以使用no_crop_face_block组件避免闪烁。
blend:半透明,即“terrain_blend”材质,如彩色玻璃。
optionalAlpha:局部透明,与alpha不同,alpha超过一定距离将不渲染,而optionalAlpha不会,能配合no_crop_face_block组件实现原版叶子效果。

# netease:solid

用于设置方块是否为实心方块主要与生物在方块内时是否受到窒息伤害有关。

使用了这个组件,自定义方块将不会产生阴影。

可参考CustomBlocksMod的customblocks:customblocks_model_flower方块。

类型 默认值 解释
value bool true 为true时,生物在方块内会受到窒息伤害
为false时,生物在方块内不会受到窒息伤害

# netease:pathable

用于设置游戏内AI在进行寻路时,方块是否被当作障碍物。

可参考CustomBlocksMod的customblocks:customblocks_model_flower方块。

类型 默认值 解释
value bool false 为true时,寻路时被当作空气
为false时,寻路时被当作障碍物,并且可在其上方行走

# netease:block_entity

用于给自定义方块添加自定义方块实体

可参考CustomBlocksMod的customblocks:customblocks_test_block_entity方块。

类型 默认值 解释
tick bool false 为true时,当玩家进入方块tick范围时,该方块每秒会发送20次ServerBlockEntityTickEvent事件
为false时,该方块不会发送ServerBlockEntityTickEvent事件
client_tick bool false 为true时,当玩家进入方块tick范围时,该方块每秒会发送20次ModBlockEntityTickClientEvent事件
为false时,该方块不会发送ModBlockEntityTickClientEvent事件
movable bool true 为true时,该方块可被粘性活塞拉回
为false时,该方块不可被粘性活塞拉回

# netease:random_tick

用于给自定义方块定义是否可以随机tick,并且设置该tick事件是否发送到脚本层。

类型 默认值 解释
enable bool false 方块是否随机tick
tick_to_script bool false 是否发送事件 BlockRandomTickServerEvent 到python脚本

# netease:redstone_property

用于给自定义方块设置红石属性

类型 默认值 解释
value str None 目前只支持break_on_push,设置之后,方块可以被活塞破坏变成掉落物,否则,方块会被活塞推动而不破坏

# netease:neighborchanged_sendto_script

类型 默认值 解释
value bool false 方块周围环境变化是否发送事件 BlockNeighborChangedServerEvent 到脚本层

# netease:connection

用于给自定义方块定义“连接”属性

使用枚举的方式配置该方块与哪些方块具有“连接”属性,并且此属性是单向的。不支持附加值。

由于方块更新的特性,“床”和“旗帜”方块在区块边缘放置时,与其他方块会出现连接失败。

可参考CustomBlocksMod的customblocks_model_wire方块。

类型 解释
blocks array(string) 数组元素为方块的identifier

目前该属性只用于netease:aabb自定义方块模型的is_connect查询:

名称 解释
query.is_connect 传入一个参数,返回该方块与对应临面上的方块是否有connection属性
参数取值与对应的面:
0-down面,1-up面,2-north面,3-south面,4-west面,5-east面。

# netease:redstone

用于配置自定义红石源与自定义红石机械元件;

可以配置自定义红石的类型,如红石源或者红石机械元件;

可以配置初始信号强度,默认为15。

类型 默认值 说明
type str 红石类型:
producer:红石源
consumer:红石机械元件
strength int 15 红石信号值,范围[0,15]

# netease:listen_block_remove

用于配置自定义方块是否监听方块的 BlockRemoveServerEvent 事件

类型 默认值 说明
value bool false 是否监听事件

# netease:may_place_on

用于配置自定义方块可存在于哪些方块的上面。

会生效于玩家右键放置方块时;以及已存在的方块下方的方块发生改变时。

可参考CustomBlocksMod示例中的customblocks_model_flower

类型 默认值 说明
block list(str) 方块identifier的列表。这些方块的所有方块状态都可放置
block_state list(object) 方块状态的列表。
每个元素只对应一个特定的方块状态,如果方块有多个种类的状态,需要考虑排列组合的所有情况
最终可在上面放置的方块是block字段与block_state字段的并集
spawn_resources bool true 已存在的方块因下方的方块发生改变而被破坏时,是否生成掉落物

# netease:fire_resistant

用于配置自定义方块是否防火。

设置为防火时,方块的掉落物会与下界合金一样,不会被火烧毁,掉进岩浆时会弹走。

可参考CustomBlocksMod示例中的customblocks_test_ore

类型 默认值 说明
value bool 是否防火

# netease:block_properties

用于配置自定义方块的方块属性

这些方块属性可以叠加,主要用于引擎对一些方块特性逻辑的判断

可参考CustomBlocksMod示例中的customblocks_slime、customblocks_flower_extend

类型 默认值 说明
properties array 所有属性字符串

其中properties数组目前支持以下字符串填充

说明
piston_block_grabber 被活塞推动时是否带动旁边方块
slime 主要用于变为移动方块(例如被活塞推)时修改对实体力的计算
breaks_when_fallen_on_by_heavy 当重力方块结束下落在该方块位置后,自身是否被毁坏

如果方块碰撞盒体积使用netease:aabb或minecraft:entity_collision改小可能会导致无法触发(目前可参考范围是边长0.4以下不会触发)。

# netease:on_stand_on

用于触发实体站在方块上的事件

可参考CustomBlocksMod示例中的customblocks_slime,利用了该事件组合做出了个模拟原版粘液块的效果。

类型 默认值 说明
send_python_event bool 是否发送事件至python

当send_python_event为true时,该方块会触发OnStandOnBlockClientEvent、OnStandOnBlockServerEvent事件。

如果方块碰撞盒体积使用netease:aabb或minecraft:entity_collision改小可能会导致无法触发(目前可参考范围是边长0.4以下不会触发)。

# netease:on_before_fall_on

用于触发实体刚下落至方块的事件,主要用于伤害计算

可参考CustomBlocksMod示例中的customblocks_slime,利用了该事件组合做出了个模拟原版粘液块的效果。

如果方块碰撞盒体积使用netease:aabb或minecraft:entity_collision改小可能会导致无法触发(目前可参考范围是边长0.4以下不会触发)。

# netease:on_after_fall_on

用于触发实体下落至方块后的事件,主要用于力的计算

可参考CustomBlocksMod示例中的customblocks_slime,利用了该事件组合做出了个模拟原版粘液块的效果。

如果方块碰撞盒体积使用netease:aabb或minecraft:entity_collision改小可能会导致无法触发(目前可参考范围是边长0.4以下不会触发)。

# netease:on_entity_inside

用于触发实体碰撞盒所在位置有方块时的事件(判断位置逻辑有无方块,与方块碰撞盒大小无关)。

当send_python_event为true时,该方块会触发OnEntityInsideBlockClientEvent、OnEntityInsideBlockServerEvent事件。

# netease:on_step_on

用于触发实体刚移动至一个实心方块上的事件

可参考CustomBlocksMod示例中的customblocks_slime,在触发该事件时进行了日志打印

# netease:on_step_off

用于触发实体刚离开一个实心方块上的事件

可参考CustomBlocksMod示例中的customblocks_slime,在触发该事件时进行了日志打印

# netease:block_random_offset

用于设置方块的偏移,能实现原版花朵的偏移效果。

注意:制作可偏移方块时,请尽量配套使用方块模型,当使用贴图方块随机偏移时,若相邻方块是不透明方块,则该方块对应的面会被裁切渲染!!普通贴图方块的物品栏渲染也可能会有异常!!

该组件会把方块的材质设置为透明,且不可与netease:render_layer的不透明材质一起共用,否则会出现渲染错误

类型 默认值 解释
x_scope [float,float] [0,0] x轴方向的偏移范围,size为2的array,取值范围为0.0~1.0,如果两个值相同则为指定点
z_scope [float,float] [0,0] z轴方向的偏移范围,size为2的array,取值范围为0.0~1.0,如果两个值相同则为指定点

# netease:block_chest

用于给方块添加箱子功能,使用了该组件会创建一个block_entity方块,会与其他block_entity逻辑有冲突,请谨慎使用。

该组件会覆盖带有base_block及其相关组件的功能。

使用了这个组件后请勿再配置netease:face_directional。

使用SetBlockNew接口创建自定义箱子的时候,需要先调用一次SetBlockNew将目标位置方块设置为Air,再使用AddTimer延后调用SetBlockNew创建自定义箱子

类型 默认值 解释
custom_description str 箱子UI上面显示的箱子名称,不填为空
chest_capacity int 必填,箱子的容量行数,取值范围1-8,如果can_pair取值为true且该值大于4,将自动变为4
can_pair bool false 是否可以与隔壁箱子组合,合成一个大箱子
is_shulker_box bool false 是否为潜影盒箱子,如果开启摧毁方块将不会掉落,与原版潜影盒功能相同,无法与隔壁箱子进行组合
mute bool true 是否关闭箱子开启与关闭时的音效
can_be_blocked bool false 是否能被阻挡,即箱子上面有阻挡的方块时能否打开箱子

# netease:no_crop_face_block

该组件能实现当两个方块相邻时,相邻面渲染其中一个方块的一面,与原版2个叶子方块相邻效果一致,不会把相邻面都裁剪掉

为了避免相邻面变黑需要在配置中新增minecraft:block_light_absorption组件并将值设置为0。

需要配合netease:render_layer使用,使用 optionalAlpha 能实现原版的叶子方块效果,使用 alpha 超过一定距离后方块将不渲染。

该组件无参数,直接在JSON按下面格式写即可调用:

"components": {
   "netease:no_crop_face_block":{}
 }

# netease:custom_tips

该组件用于自定义方块Item的物品信息描述,与自定义物品中的 netease:customtips 作用相同

类型 默认值 解释
value str 物品名称 物品的描述信息