---
front:
hard: 入门
time: 分钟
---

# 自定义武器及工具

## 概述

属于特殊的自定义物品，在支持自定义物品所有特性的基础上，还具有武器或工具相关的功能。



## 注册

1. 与自定义基础物品的注册1-6步相同

2. 在behavior/netease_items_beh的json中添加武器/工具相关的定义，包括：

   custom_item_type为weapon

   一个netease:weapon组件，必填。组件的参数见[json组件](#json组件)

   设置最大堆叠数量，可选

   设置耐久度，可选

![avatar](./picture/customitem/tool1.png)



```python
{
  "format_version": "1.10",
  "minecraft:item": {
    "description": {
      "identifier": "customitems:test_sword",
      "custom_item_type": "weapon"
    },

    "components": {
      "minecraft:max_stack_size":1,
      "minecraft:max_damage":153,
      "netease:weapon":{
        "type":"sword",
        "level":3,
        "speed":8,
        "attack_damage":7,
        "enchantment":10
      }
    }
  }
}
```



## JSON组件

### description

| 键       | 类型 | 默认值    | 解释                                           |
| -------- | ---- | --------- | ---------------------------------------------- |
| category | str  | Equipment | 与普通物品不同，武器/工具的默认分类是Equipment |

### 原版components

* minecraft:max_stack_size

    自定义武器/工具只支持设置为1

### 网易components

* netease:weapon

| 键            | 类型 | 默认值 | 解释                                                         |
| ------------- | ---- | ------ | ------------------------------------------------------------ |
| type          | str  |        | 武器/工具的类型,目前支持类型有：<br>sword：剑<br>shovel：铲<br>pickaxe：镐<br>hatchet：斧<br>hoe：锄头 |
| level         | int  |        | 武器/工具的level说明及修复信息，下面以镐举例<br>1. 对于镐，对应挖掘等级<br>即当使用镐挖掘某些方块时，镐子的挖掘等级大于等于方块的挖掘等级，才会产生掉落物。<br>对于原版镐子，木镐与金镐是0，石镐是1，铁镐是2，钻石镐是3<br>2. 并且该值与铁砧的修复材料有关。<br>level为0：当速度为2对应木板,否则对应金锭 <br>level为1：对应石头<br>level为2：对应铁锭<br>level为3：对应钻石<br>level大于3：无法使用铁砧修复 |
| speed         | int  | 0      | 对采集工具生效，表示挖掘方块时的基础速度                     |
| attack_damage | int  | 0      | 攻击伤害                                                     |
| enchantment   | int  | 0      | 附魔能力。该值的解释见[官方wiki](https://zh.minecraft.wiki/w/%E9%99%84%E9%AD%94%EF%BC%88%E7%89%A9%E5%93%81%E4%BF%AE%E9%A5%B0%EF%BC%89#%E9%99%84%E9%AD%94%E8%83%BD%E5%8A%9B) |



## demo解释

[CustomItemsMod](../../13-模组SDK编程/60-Demo示例.md#CustomItemsMod)中定义了一个自定义武器：

* customitems:test_sword

  剑类型的自定义武器