Minecraft Wiki

除另有声明,转载时均必须注明出处若簡繁轉換出錯,請以遊戲內為準请勇于扩充与修正内容有兴趣逛逛我们的微博沟通交流,欢迎到社区专页需要协助,请在告示板留言

了解更多

Minecraft Wiki
Advertisement

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

食物食用后给玩家增加的效果

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

当物品击中除了实体以外的东西触发事件


物品组件设置:


{
"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
            }
          ]
        }
      }
   }
}


Advertisement