Template:Bedrock Edition Developer Documentation
物品文档 版本: 1.16.100.4
自定义物品
自定义物品是在behavior_packs附加包的名字'/items目录下的json文件中设置的。
物品组件
以下是所有物品的组件及其设置的列表。
| 名称 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| minecraft:armor | json对象 | 确定该盔甲物品的防御点数
protection 该盔甲物品有多少防御点数 textrue_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 食物食用后给玩家增加的效果 |
物品组件设置:
{
"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": "minecraft:apple",
"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
}
]
}
}
}
}