Template:Bedrock Edition Developer Documentation 这是基岩版1.16.100以上版本的物品文档。
自定义物品文件位置
behavior_packs/附加包名字/items/XXX(名字自取).json
物品组件
以下是所有物品组件及其设置的列表。
名称
类型
描述
minecraft:armor
json对象
盔甲物品组件。
protection
该盔甲物品有多少护甲值
texture_type
该盔甲物品所使用的纹理类型
注意:马铠仅限于皮革,铁,金或钻石
minecraft:block_placer
json对象
作物物品组件。作物物品是可以种植的物品
block
block:设置该物品所对应方块的名字
use_on
包含该物品可用于方块的方块描述列表,如果为空,则可以在所有方块上使用
minecraft:cooldown
json对象
该物品的冷却时间,该物品使用后,在所设置的冷却时间内无法再次使用
category
该物品的冷却类型
duration
冷却时间
minecraft:digger
json对象
工具物品组件。
destroy_speeds
破坏方块的速度
on_dig
当你用该物品破坏一个没有列出挖掘速度的方块时触发
use_efficiency
是否使用效率,默认值为false
minecraft:display_name
json对象
一个物品的显示名称
value
为一个物品设置显示名称
minecraft:dye
json对象
染料物品组件。我的世界目前有16种颜色的染料
color
定义它是什么颜色的染料
minecraft:entity_placer
json对象
刷怪蛋物品组件,您可以指定该物品可用于/免除的方块
entity
设置将被放置生物
use_on
包含该物品可用于的方块描述列表,如果留空,则允许所有方块
dispense_on
包含该物品可免除的方块描述列表,如果留空,则允许所有方块
minecraft:food
json对象
食物物品组件。
can_always_eat
如果是true此物品始终都可以食用(包括你不饿的时候),默认为false
nutrition
设置物品提供多少饱和度
on_consume
食用事件
saturation_modifier
此修改器用于这个公式:(nutrition*saturation_modifier*2),当你吃下它便可触发此饱和buff
using_converts_to
使用时,将这个物品转化为此组件指定的物品
effects
食物食用后给玩家增加的效果
remove_effects
食物食用后给玩家删除的效果
on_use_action
食物食用的动作(目前只支持传送)
on_use_range
使用坐标范围
cooldown_type
冷却类型
cooldown_time
冷却时间,单位为tick
minecraft:fuel
json对象
通过此组件,可让物品充当燃料
duration
设置它可以燃烧几秒
minecraft:knockback_resistance
json对象
击退抗性组件,可用于提供抗击退的物品上
protection
该物品的击退抗性,最大值为1.0
minecraft:icon
json对象
设置物品图标
frame
要显示图标帧的索引或表达式,默认值是0
legacy_id
给更旧的物品的旧id
texture
填写来自与纹理文件关联的resource_pack / textures / item_texture.json'texture_data'对象的键,例如:blaze_powder
minecraft:on_use
json对象
该组件允许在物品使用时接收事件
on_use
使用时触发事件
minecraft:on_use_on
json对象
该组件允许在物品对世界中的方块使用时接收事件
on_use_on
物品对方块使用时触发事件
minecraft:projectile
json对象
该组件允许自定义投掷物,投掷物像箭一样射出
minium_critical_power
决定你需要对一个物品充能多久使它射出造成致命一击
projectile_entity
将被射出的实体
minecraft:repairable
json对象
该组件允许定义被修理耐久值多少
on_repaired
物品修理完后触发事件
repair_items
列出用来修理该物品的道具(items),修复耐久值(repair_amount)
minecraft:weapon
json对象
该组件允许定义一把武器
on_hit_block
物品击中方块时触发事件
on_hurt_entity
物品击中实体时触发事件
on_not_hurt_entity
当物品击中除了实体以外的东西触发事件
minecraft:wearable
json对象
该组件允许定义一件可穿戴物品【该组件对于一般的物品可有可无】
slot
物品穿戴进的格子
一共有:slot.weapon.mainhand, slot.weapon.offhand, slot.armor.head, slot.armor.chest, slot.armor.legs, slot.armor.feet, slot.hotbar, slot.inventory, slot.enderchest, slot.saddle, slot.armor, slot.chest
minecraft:shooter
json对象
该组件允许定义像弓一样可射击的物品
ammunition
弹药
charge_on_draw
拉弓充能,默认为false
launch_power_scale
发射强度比,默认为1.0
max_draw_duration
拉弓充能满需要的最大时间,默认为0
max_launch_power
发射增加强度的比,默认为1.0
scale_power_by_draw_duration
通过拉弓时长缩放强度(布尔值)
minecraft:throwable
json对象
该组件允许将物品抛出,例如雪球,三叉戟
do_swing_animation
抛射时做出摇摆动画,默认为false
launch_power_scale
发射物增加强度的规模,默认为1.0
max_draw_duration
蓄力可投掷物的最长时间,默认为0.0
scale_power_by_draw_duration
投掷力量是否随着蓄力时长增加,默认为false
minecraft:foil
布尔值
设置该物品是否自带附魔光效,默认为false。
minecraft:damage
数值
设置该物品的攻击伤害。
物品组件设置
{
"format_version": "1.16.100",
"minecraft:item": {
"description": {
"identifier": "minecraft:apple"
},
"components": {
"minecraft:max_damage": 10, // 可以使物品拥有耐久度
"minecraft:hand_equipped": false, // 是否以工具形式握持该物品
"minecraft:stacked_by_data": false, // 是否根据数据值决定堆叠
"minecraft:foil": false, // 可以使物品拥有附魔光泽
"minecraft:block": , // 方块名字,可留空
"minecraft:max_stack_size": 64, // 设置物品最大堆叠数量,注意,该值不能超过64
"minecraft:use_duration": 32, // 物品的使用时间
"minecraft:food": { //使用此组件定义自定义食物
"nutrition": 4, // 食物的营养值
"saturation_modifier": "low", // 饱和度等级,有poor,low,normal,good,max,supernatural六个等级,系数分别是0.1,0.3,0.6,0.8,1.0,1.2
"using_converts_to": , // 使用后转化为的Item,如使用甜菜汤后留下碗
"on_use_action": none, // 使用食品产生的动作,目前仅支持传送到其他位置。选填'chorus_teleport' 或 'none'
"on_use_range": [0, 10, 4], // 传送位置x,y,z的偏移值
"cooldown_type": none, // 冷却类型,'chorusfruit' or 'none'.
"cooldown_time": 4, // 冷却时间,单位是tick
"can_always_eat": true, // 是否可以一直使用
"effects": [ // 使用后给玩家buff
{
"name": "regeneration", // 状态名字: regeneration, absorption, resistance, fire_resistance
"chance": 1.0, // 状态产生的概率,取值为0到1之间
"duration": 30, // 持续时间
"amplifier": 4, // 等级
},
{
"name": "absorption",
"chance" : 1.0,
"duration" : 120,
"amplifier" : 3
},
},
"minecraft:seed": {
"crop_result": "sweet_berry_bush", // 作物的结果
"plant_at": ["grass","dirt","podzol"] // 规定作物只能种植在哪些方块上
}
}
}
}
Items
表示单个物品。物品的格式为:您所设置的物品名称.json。
下面是一个示范。
代码举例
{
"format_version": "1.16.100",
"minecraft:item": {
"description": {
"identifier": "cm:sandwich",
"category": "Items"
},
"components": {
"minecraft:hand_equipped": false,
"minecraft:max_stack_size": 64,
"minecraft:foil": false,
"minecraft: stack_by_data": true,
"minecraft:use_duration": 32,
"minecraft:food": {
"nutrition": 5,
"can_always_eat": false,
"saturation_modifier": "normal",
"effects":[
{
"name":"nausea",
"chance":1,
"duration":30,
"amplifier":1
}
]
}
}
}
}
protection
该盔甲物品有多少护甲值
texture_type
该盔甲物品所使用的纹理类型
注意:马铠仅限于皮革,铁,金或钻石
block
block:设置该物品所对应方块的名字
use_on
包含该物品可用于方块的方块描述列表,如果为空,则可以在所有方块上使用
category
该物品的冷却类型
duration
冷却时间
destroy_speeds
破坏方块的速度
on_dig
当你用该物品破坏一个没有列出挖掘速度的方块时触发
use_efficiency
是否使用效率,默认值为false
value
为一个物品设置显示名称
color
定义它是什么颜色的染料
entity
设置将被放置生物
use_on
包含该物品可用于的方块描述列表,如果留空,则允许所有方块
dispense_on
包含该物品可免除的方块描述列表,如果留空,则允许所有方块
can_always_eat
如果是true此物品始终都可以食用(包括你不饿的时候),默认为false
nutrition
设置物品提供多少饱和度
on_consume
食用事件
saturation_modifier
此修改器用于这个公式:(nutrition*saturation_modifier*2),当你吃下它便可触发此饱和buff
using_converts_to
使用时,将这个物品转化为此组件指定的物品
effects
食物食用后给玩家增加的效果
remove_effects
食物食用后给玩家删除的效果
on_use_action
食物食用的动作(目前只支持传送)
on_use_range
使用坐标范围
cooldown_type
冷却类型
cooldown_time
冷却时间,单位为tick
duration
设置它可以燃烧几秒
protection
该物品的击退抗性,最大值为1.0
frame
要显示图标帧的索引或表达式,默认值是0
legacy_id
给更旧的物品的旧id
texture
填写来自与纹理文件关联的resource_pack / textures / item_texture.json'texture_data'对象的键,例如:blaze_powder
on_use
使用时触发事件
on_use_on
物品对方块使用时触发事件
minium_critical_power
决定你需要对一个物品充能多久使它射出造成致命一击
projectile_entity
将被射出的实体
on_repaired
物品修理完后触发事件
repair_items
列出用来修理该物品的道具(items),修复耐久值(repair_amount)
on_hit_block
物品击中方块时触发事件
on_hurt_entity
物品击中实体时触发事件
on_not_hurt_entity
当物品击中除了实体以外的东西触发事件
slot
物品穿戴进的格子 一共有:slot.weapon.mainhand, slot.weapon.offhand, slot.armor.head, slot.armor.chest, slot.armor.legs, slot.armor.feet, slot.hotbar, slot.inventory, slot.enderchest, slot.saddle, slot.armor, slot.chest
ammunition
弹药
charge_on_draw
拉弓充能,默认为false
launch_power_scale
发射强度比,默认为1.0
max_draw_duration
拉弓充能满需要的最大时间,默认为0
max_launch_power
发射增加强度的比,默认为1.0
scale_power_by_draw_duration
通过拉弓时长缩放强度(布尔值)
do_swing_animation
抛射时做出摇摆动画,默认为false
launch_power_scale
发射物增加强度的规模,默认为1.0
max_draw_duration
蓄力可投掷物的最长时间,默认为0.0
scale_power_by_draw_duration
投掷力量是否随着蓄力时长增加,默认为false
{
"format_version": "1.16.100",
"minecraft:item": {
"description": {
"identifier": "minecraft:apple"
},
"components": {
"minecraft:max_damage": 10, // 可以使物品拥有耐久度
"minecraft:hand_equipped": false, // 是否以工具形式握持该物品
"minecraft:stacked_by_data": false, // 是否根据数据值决定堆叠
"minecraft:foil": false, // 可以使物品拥有附魔光泽
"minecraft:block": , // 方块名字,可留空
"minecraft:max_stack_size": 64, // 设置物品最大堆叠数量,注意,该值不能超过64
"minecraft:use_duration": 32, // 物品的使用时间
"minecraft:food": { //使用此组件定义自定义食物
"nutrition": 4, // 食物的营养值
"saturation_modifier": "low", // 饱和度等级,有poor,low,normal,good,max,supernatural六个等级,系数分别是0.1,0.3,0.6,0.8,1.0,1.2
"using_converts_to": , // 使用后转化为的Item,如使用甜菜汤后留下碗
"on_use_action": none, // 使用食品产生的动作,目前仅支持传送到其他位置。选填'chorus_teleport' 或 'none'
"on_use_range": [0, 10, 4], // 传送位置x,y,z的偏移值
"cooldown_type": none, // 冷却类型,'chorusfruit' or 'none'.
"cooldown_time": 4, // 冷却时间,单位是tick
"can_always_eat": true, // 是否可以一直使用
"effects": [ // 使用后给玩家buff
{
"name": "regeneration", // 状态名字: regeneration, absorption, resistance, fire_resistance
"chance": 1.0, // 状态产生的概率,取值为0到1之间
"duration": 30, // 持续时间
"amplifier": 4, // 等级
},
{
"name": "absorption",
"chance" : 1.0,
"duration" : 120,
"amplifier" : 3
},
},
"minecraft:seed": {
"crop_result": "sweet_berry_bush", // 作物的结果
"plant_at": ["grass","dirt","podzol"] // 规定作物只能种植在哪些方块上
}
}
}
}
Items
{
"format_version": "1.16.100",
"minecraft:item": {
"description": {
"identifier": "cm:sandwich",
"category": "Items"
},
"components": {
"minecraft:hand_equipped": false,
"minecraft:max_stack_size": 64,
"minecraft:foil": false,
"minecraft: stack_by_data": true,
"minecraft:use_duration": 32,
"minecraft:food": {
"nutrition": 5,
"can_always_eat": false,
"saturation_modifier": "normal",
"effects":[
{
"name":"nausea",
"chance":1,
"duration":30,
"amplifier":1
}
]
}
}
}
}