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"] // 规定作物只能种植在哪些方块上
}
}
}
}
}
代码举例
{
"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
}
]
}
}
}
}