---
sidebarDepth: 1
---
# 物品

# 索引

包括物品属性的接口，物品的生成与获取见[玩家/背包](玩家/索引.md#背包)，[实体/背包](实体/索引.md#背包)，[方块/容器](方块/索引.md#容器)，物品实体的生成与获取见[世界/实体管理](世界/索引.md#实体管理)

---

| 接口 | <div style="width: 3em"></div> | 描述 |
| --- | --- | --- |
| [CancelShearsDestoryBlockSpeed](物品.md#cancelshearsdestoryblockspeed) | <span style="display:inline;color:#ff5555">服务端</span> |  取消剪刀对某一方块的破坏速度设置 |
| [CancelShearsDestoryBlockSpeedAll](物品.md#cancelshearsdestoryblockspeedall) | <span style="display:inline;color:#ff5555">服务端</span> |  取消剪刀对全部方块的破坏速度设置 |
| [ChangeArmorTextures](物品.md#changearmortextures) | <span style="display:inline;color:#7575f9">客户端</span> | 修改盔甲在场景中显示和在UI中显示的贴图 |
| [ChangeItemTexture](物品.md#changeitemtexture) | <span style="display:inline;color:#7575f9">客户端</span> | 替换物品的贴图，修改后所有用到该贴图的物品都会被改变，后续创建的此类物品也会被改变。会同时修改物品在UI界面上的显示，手持时候的显示与场景掉落的显示。 |
| [GetAllEnchantsInfo](物品.md#getallenchantsinfo) | <span style="display:inline;color:#ff5555">服务端</span> | 获取目前已注册的所有附魔信息 |
| [GetAllEnchantsInfo](物品.md#getallenchantsinfo) | <span style="display:inline;color:#7575f9">客户端</span> | 获取目前已注册的所有附魔信息 |
| [GetCustomName](物品.md#getcustomname) | <span style="display:inline;color:#ff5555">服务端</span> | 获取物品的自定义名称，与铁砧修改的名称一致 |
| [GetItemBasicInfo](物品.md#getitembasicinfo) | <span style="display:inline;color:#ff5555">服务端</span> | 获取物品的基础信息 |
| [GetItemBasicInfo](物品.md#getitembasicinfo) | <span style="display:inline;color:#7575f9">客户端</span> | 获取物品的基础信息 |
| [GetItemDefenceAngle](物品.md#getitemdefenceangle) | <span style="display:inline;color:#ff5555">服务端</span> | 获取盾牌物品的抵挡角度范围 |
| [GetItemDurability](物品.md#getitemdurability) | <span style="display:inline;color:#ff5555">服务端</span> | 获取指定槽位的物品耐久 |
| [GetItemEffectName](物品.md#getitemeffectname) | <span style="display:inline;color:#7575f9">客户端</span> | 获取物品的状态描述，如：§7保护 0§r |
| [GetItemFormattedHoverText](物品.md#getitemformattedhovertext) | <span style="display:inline;color:#7575f9">客户端</span> | 获取物品的格式化hover文本，如：§f灾厄旗帜§r |
| [GetItemHoverName](物品.md#getitemhovername) | <span style="display:inline;color:#7575f9">客户端</span> | 获取物品的hover名称，如：灾厄旗帜§r |
| [GetItemInfoByBlockName](物品.md#getiteminfobyblockname) | <span style="display:inline;color:#ff5555">服务端</span> | 通过方块名称及aux值获取物品信息 |
| [GetItemLayer](物品.md#getitemlayer) | <span style="display:inline;color:#ff5555">服务端</span> | 获取物品的叠加贴图。物品叠加贴图详见SetItemLayer |
| [GetItemMaxDurability](物品.md#getitemmaxdurability) | <span style="display:inline;color:#ff5555">服务端</span> | 获取指定槽位的物品耐最大耐久 |
| [GetItemTags](物品.md#getitemtags) | <span style="display:inline;color:#ff5555">服务端</span> | 获取物品在minecraft:tags中定义的tags列表 |
| [GetItemTags](物品.md#getitemtags) | <span style="display:inline;color:#7575f9">客户端</span> | 获取物品在minecraft:tags中定义的tags列表 |
| [GetItemTexture](物品.md#getitemtexture) | <span style="display:inline;color:#7575f9">客户端</span> | 获取item_texture.json中物品的贴图路径。 |
| [GetLoadItems](物品.md#getloaditems) | <span style="display:inline;color:#ff5555">服务端</span> | 获取已经加载的物品id |
| [GetUserDataInEvent](物品.md#getuserdatainevent) | <span style="display:inline;color:#ff5555">服务端</span> | 使物品相关服务端事件的<a href="../../../mcguide/20-玩法开发/10-基本概念/1-我的世界基础概念.html#物品信息字典#物品信息字典">物品信息字典</a>参数带有userData。在mod初始化时调用即可 |
| [GetUserDataInEvent](物品.md#getuserdatainevent) | <span style="display:inline;color:#7575f9">客户端</span> | 使物品相关客户端事件的<a href="../../../mcguide/20-玩法开发/10-基本概念/1-我的世界基础概念.html#物品信息字典#物品信息字典">物品信息字典</a>参数带有userData。在mod初始化时调用即可 |
| [LookupItemByName](物品.md#lookupitembyname) | <span style="display:inline;color:#ff5555">服务端</span> | 判定指定identifier的物品是否存在 |
| [RemoveItemLayer](物品.md#removeitemlayer) | <span style="display:inline;color:#ff5555">服务端</span> | 移除物品的叠加贴图。物品叠加贴图详见SetItemLayer |
| [SetAttackDamage](物品.md#setattackdamage) | <span style="display:inline;color:#ff5555">服务端</span> |  设置物品的攻击伤害值 |
| [SetCompassEntity](物品.md#setcompassentity) | <span style="display:inline;color:#7575f9">客户端</span> | 设置指南针朝向的实体 |
| [SetCompassTarget](物品.md#setcompasstarget) | <span style="display:inline;color:#7575f9">客户端</span> | 设置指南针的朝向位置 |
| [SetCustomName](物品.md#setcustomname) | <span style="display:inline;color:#ff5555">服务端</span> | 设置物品的自定义名称，与使用铁砧重命名一致 |
| [SetItemDefenceAngle](物品.md#setitemdefenceangle) | <span style="display:inline;color:#ff5555">服务端</span> | 设置盾牌物品的抵挡角度范围 |
| [SetItemDurability](物品.md#setitemdurability) | <span style="display:inline;color:#ff5555">服务端</span> | 设置物品的耐久值 |
| [SetItemLayer](物品.md#setitemlayer) | <span style="display:inline;color:#ff5555">服务端</span> | 设置物品的叠加贴图，可以在物品的上层与下层叠加自定义贴图。具体使用可参考CustomItemsMod示例。 |
| [SetItemMaxDurability](物品.md#setitemmaxdurability) | <span style="display:inline;color:#ff5555">服务端</span> | 设置物品的最大耐久值 |
| [SetItemTierLevel](物品.md#setitemtierlevel) | <span style="display:inline;color:#ff5555">服务端</span> |  设置工具类物品的挖掘等级 |
| [SetItemTierSpeed](物品.md#setitemtierspeed) | <span style="display:inline;color:#ff5555">服务端</span> |  设置工具类物品的挖掘速度(可通过userData中的ModTierSpeed获取挖掘速度) |
| [SetMaxStackSize](物品.md#setmaxstacksize) | <span style="display:inline;color:#ff5555">服务端</span> |  设置物品的最大堆叠数量（存档） |
| [SetShearsDestoryBlockSpeed](物品.md#setshearsdestoryblockspeed) | <span style="display:inline;color:#ff5555">服务端</span> |  设置剪刀对某一方块的破坏速度 |

## CancelShearsDestoryBlockSpeed

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.itemCompServer.ItemCompServer

- 描述

     取消剪刀对某一方块的破坏速度设置

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | blockName | str | 方块名称,包含命名空间 |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | bool | 设置是否成功 |

- 示例

```python
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateItem(entityId)
comp.CancelShearsDestoryBlockSpeed("minecraft:obsidian")
```



## CancelShearsDestoryBlockSpeedAll

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.itemCompServer.ItemCompServer

- 描述

     取消剪刀对全部方块的破坏速度设置

- 参数

    无

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | bool | 设置是否成功 |

- 示例

```python
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateItem(entityId)
comp.CancelShearsDestoryBlockSpeedAll()
```



## ChangeArmorTextures

<span style="display:inline;color:#7575f9">客户端</span>

method in mod.client.component.actorRenderCompClient.ActorRenderCompClient

- 描述

    修改盔甲在场景中显示和在UI中显示的贴图

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | armorIdentifier | str | 盔甲标识符，格式[namespace:name:auxvalue]，auxvalue默认为0 |
    | texturesDict | dict | 场景中目标贴图的映射表，格式可参考"definitions/attachables/diamond_helmet.json"配置 |
    | uiIconTexture | str | 盔甲UI图标的贴图, 为None或者""的话表示不修改UI上的图标 |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | bool | 修改是否成功（因为采用延迟加载，此处返回成功不代表参数中的贴图路径正确，路径错误会导致渲染时贴图丢失显示异常） |

- 备注
    - 无法跟物品的贴图动画同时使用
    - 有一定性能消耗，不建议频繁调用

- 示例

```python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateActorRender(levelId)
# 修改钻石头盔的显示为黄金头盔
textureDict = {
    "default": "textures/models/armor/gold_1",
    "enchanted": "textures/misc/enchanted_item_glint"
}
print(comp.ChangeArmorTextures("minecraft:diamond_helmet", textureDict, "textures/items/gold_helmet"))
```



## ChangeItemTexture

<span style="display:inline;color:#7575f9">客户端</span>

method in mod.client.component.itemCompClient.ItemCompClient

- 描述

    替换物品的贴图，修改后所有用到该贴图的物品都会被改变，后续创建的此类物品也会被改变。会同时修改物品在UI界面上的显示，手持时候的显示与场景掉落的显示。

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | identifier | str | 物品标识符，格式[namespace:name:auxvalue]，auxvalue默认为0 |
    | texturePath | str | 贴图路径 |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | bool | 是否修改成功（因为采用延迟加载，此处返回成功不代表贴图路径正确，路径错误会导致渲染时贴图丢失显示异常） |

- 备注
    - 因为会同时修改用到此贴图的所有物品，所以使用的时候尽量谨慎，不建议改原版的物品，建议只用于修改用到自定义新贴图的物品。
    - 序列帧贴图物品暂不支持动态修改贴图
    - 部分物品有特殊逻辑无法修改：箱子，旗帜，生物头颅，盾牌，三叉戟，鱼杆

- 示例

```python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateItem(levelId)
print(comp.ChangeItemTexture("mytool:hatchet_1:0", "textures/items/hatchet_1"))
```



## GetAllEnchantsInfo

<span style="display:inline;color:#ff5555">服务端</span><span style="display:inline;color:#7575f9">客户端</span>

### 服务端接口

<span id="s0"></span>
method in mod.server.component.itemCompServer.ItemCompServer

- 描述

    获取目前已注册的所有附魔信息

- 参数

    无

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | list(dict) | 附魔信息字典<a href="../../../mcguide/20-玩法开发/10-基本概念/1-我的世界基础概念.html#附魔信息字典#附魔信息字典">附魔信息字典</a> |

- 备注
    - 1.目前能获取原生及自定义附魔信息
        2.由于原生附魔的消耗存在不相同的计算规则，目前不提供原生附魔的costs信息

- 示例

```python
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateItem(levelId)
comp.GetAllEnchantsInfo()
```



### 客户端接口

<span id="c0"></span>
method in mod.client.component.itemCompClient.ItemCompClient

- 描述

    获取目前已注册的所有附魔信息

- 参数

    无

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | list(dict) | 附魔信息字典<a href="../../../mcguide/20-玩法开发/10-基本概念/1-我的世界基础概念.html#附魔信息字典#附魔信息字典">附魔信息字典</a> |

- 备注
    - 1.目前能获取原生及自定义附魔信息
        2.由于原生附魔的消耗存在不相同的计算规则，目前不提供原生附魔的costs信息

- 示例

```python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateItem(levelId)
comp.GetAllEnchantsInfo()
```



## GetCustomName

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.itemCompServer.ItemCompServer

- 描述

    获取物品的自定义名称，与铁砧修改的名称一致

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | itemDict | dict | <a href="../../../mcguide/20-玩法开发/10-基本概念/1-我的世界基础概念.html#物品信息字典#物品信息字典">物品信息字典</a>。如果是接口获取的itemDict，应该包含userData，即getUserData应该为True |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | str | 自定义名称 |

- 示例

```python
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateItem(playerId)
itemDict = comp.GetPlayerItem(serverApi.GetMinecraftEnum().ItemPosType.CARRIED, 0, True)
name = comp.GetCustomName(itemDict)
```



## GetItemBasicInfo

<span style="display:inline;color:#ff5555">服务端</span><span style="display:inline;color:#7575f9">客户端</span>

### 服务端接口

<span id="s0"></span>
method in mod.server.component.itemCompServer.ItemCompServer

- 描述

    获取物品的基础信息

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | itemName | str | item的identifier |
    | auxValue | int | 物品的附加值auxvalue，默认为0 |
    | isEnchanted | bool | 是否附魔，默认为False。用于返回的id_aux |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | dict | 基础信息，详见备注 |

- 备注
    - auxValue默认值是0，可以不设置。如果物品不存在，返回值为None
        | 关键字     | 数据类型              | 说明     |
        | ----------| --------------------- | ---------|
        | itemName       | str | 本地化的物品名字 |
        | maxStackSize |int| 物品最大堆叠数目 |
        | maxDurability |int| 物品最大耐久值 |
        | id_aux |int| 主要用于客户端的ui绑定，详见客户端接口 |
        | tierDict |dict| 自定义方块定义的挖掘相关的属性 netease:tier,没有设置时返回None |
        | itemCategory |str| 创造栏分类 |
        | itemType |str| 物品类型 |
        | customItemType |str| 自定义物品类型 |
        | customTips |str| 自定义物品/方块tips |
        | itemTierLevel |int| 工具等级 |
        | fuelDuration |float| 燃料时长 |
        | foodNutrition |int| 食物营养值 |
        | foodSaturation |float| 食物饱食度 |
        | weaponDamage |int| 武器攻击力 |
        | armorDefense |int| 防具防御力 |
        | armorSlot |int| 防具槽位 |
        | armorToughness |int| 防具韧性 |
        | armorKnockbackResistance |float| 防具击退抗性 |
    - 部分原版物品较为特殊，获取不到个别字段的返回值
        方块类燃料获取不到燃料时长，弓、弩获取不到武器攻击力，蛋糕获取不到营养值和饱食度，马铠获取不到防具防御力，上述物品获取对应字段返回值为0
    - 创造栏分类说明
        | 创造栏分类 | 意义 |
        | --------- | -----|
        | construction | 建筑 |
        | nature | 自然 |
        | equipment | 装备 |
        | items | 物品 |
        | custom | 自定义 |
        | 空字符串 | 不在创造栏 |
    - 物品类型，值为空字符串或者下列类型名之一:
        | 类型名 | 意义 |
        | ----- | ----- |
        | book | 书 |
        | sword | 剑 |
        | shears | 剪刀 |
        | axe | 斧头 |
        | clock | 时钟 |
        | bucket | 桶 |
        | fishing_rod | 钓鱼竿 |
        | hoe | 锄头 |
        | shovel | 锹 |
        | pickaxe | 镐 |
        | dye | 骨粉 |
        | food | 食物 |
        | block | 方块 |
        | armor | 盔甲 |
        | custom_ranged_weapon | 自定义远程武器 |
        | compass | 指南针 |
        | trident | 三叉戟 |
        | potion | 药水 |
        | crossbow | 弩 |
    - 自定义物品类型物品类型，值为行为包里minecraft:item内description的custom_item_type字段值
    - 工具等级代表不同的材质，没有工具等级时为值-1，工具等级与材质对应关系如下
        | 工具等级 | 材质 |
        | ------- | ---- |
        | 0 | 木制/金制工具 |
        | 1 | 石制工具 |
        | 2 | 铁制工具 |
        | 3 | 钻石工具 |
        | 4 | 合金工具 |

- 示例

```python
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateItem(levelId)
comp.GetItemBasicInfo("minecraft:bow")
```



### 客户端接口

<span id="c0"></span>
method in mod.client.component.itemCompClient.ItemCompClient

- 描述

    获取物品的基础信息

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | itemName | str | item的identifier |
    | auxValue | int | 物品的附加值auxvalue，默认为0 |
    | isEnchanted | bool | 是否附魔，默认为False。用于返回的id_aux |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | dict | 基础信息字典，见备注 |

- 备注
    - auxValue默认值是0，可以不设置。如果物品不存在，返回值为None
        | 关键字     | 数据类型              | 说明     |
        | ----------| --------------------- | ---------|
        | itemName       | str | 本地化的物品名字 |
        | maxStackSize |int| 物品最大堆叠数目 |
        | maxDurability |int| 物品最大耐久值 |
        | id_aux |int| 用于给UI的inventory_item_renderer类型控件绑定#item_id_aux字段，详见备注 |
        | tierDict |dict| 自定义方块定义的挖掘相关的属性 netease:tier,没有设置时返回None |
        | itemCategory |str| 创造栏分类 |
        | itemType |str| 物品类型 |
        | customItemType |str| 自定义物品类型 |
        | customTips |str| 自定义物品/方块tips |
        | itemTierLevel |int| 工具等级 |
        | fuelDuration |float| 燃料时长 |
        | foodNutrition |int| 食物营养值 |
        | foodSaturation |float| 食物饱食度 |
        | weaponDamage |int| 武器攻击力 |
        | armorDefense |int| 防具防御力 |
        | armorSlot |int| 防具槽位 |
        | armorToughness |int| 防具韧性 |
        | armorKnockbackResistance |float| 防具击退抗性 |
    - 部分原版物品较为特殊，获取不到个别字段的返回值
        方块类燃料获取不到燃料时长，弓、弩获取不到武器攻击力，蛋糕获取不到营养值和饱食度，马铠获取不到防具防御力，上述物品获取对应字段返回值为0
    - id_aux字段的示例：
        在ui中添加一个inventory_item_renderer控件以及#item_id_aux的绑定
        ```json
        "my_item_renderer": {
            "type": "custom",
            "renderer": "inventory_item_renderer",
            "size": [ 160, 160 ],
            "bindings" : [
                {
                    "binding_condition" : "always_when_visible",
                    "binding_name" : "#GetItemIdAux",
                    "binding_name_override" : "#item_id_aux"
                }
            ]
        }
        ```
        
        然后在python中添加绑定回调
        ```python
        @ViewBinder.binding(ViewBinder.BF_BindInt, "#GetItemIdAux")
        def OnStarkGridResize(self):
            comp = clientApi.GetEngineCompFactory().CreateItem(levelId)
            info = comp.GetItemBasicInfo("minecraft:bow", 0, True)
            return info['id_aux']
        ```
    - 创造栏分类说明
        | 创造栏分类 | 意义 |
        | --------- | -----|
        | construction | 建筑 |
        | nature | 自然 |
        | equipment | 装备 |
        | items | 物品 |
        | custom | 自定义 |
    - 物品类型，值为空字符串或者下列类型名之一:
        | 类型名 | 意义 |
        | ----- | ----- |
        | book | 书 |
        | sword | 剑 |
        | shears | 剪刀 |
        | axe | 斧头 |
        | clock | 时钟 |
        | bucket | 桶 |
        | fishing_rod | 钓鱼竿 |
        | hoe | 锄头 |
        | shovel | 锹 |
        | pickaxe | 镐 |
        | dye | 骨粉 |
        | food | 食物 |
        | block | 方块 |
        | armor | 盔甲 |
        | custom_ranged_weapon | 自定义远程武器 |
        | compass | 指南针 |
        | trident | 三叉戟 |
        | potion | 药水 |
        | crossbow | 弩 |
    - 自定义物品类型物品类型，值为行为包里minecraft::item内的custom_item_type字段值
    - 工具等级代表不同的材质，没有工具等级时为值-1，工具等级与材质对应关系如下
        | 工具等级 | 材质 |
        | ------- | ---- |
        | 0 | 木制/金制工具 |
        | 1 | 石制工具 |
        | 2 | 铁制工具 |
        | 3 | 钻石工具 |
        | 4 | 合金工具 |

- 示例

```python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateItem(levelId)
comp.GetItemBasicInfo("minecraft:bow")
```



## GetItemDefenceAngle

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.itemCompServer.ItemCompServer

- 描述

    获取盾牌物品的抵挡角度范围

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | posType | int | [ItemPosType枚举](../枚举值/ItemPosType.md) |
    | slotPos | int | 槽位 |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | list(float) | 角度范围 |

- 备注
    - 当传入的玩家id不正确，玩家手里没手持盾牌，传入不存在的槽位时，会返回空列表

- 示例

```python
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateItem(playerId)
comp.GetItemDefenceAngle(serverApi.GetMinecraftEnum().ItemPosType.INVENTORY, 0)
```



## GetItemDurability

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.itemCompServer.ItemCompServer

- 描述

    获取指定槽位的物品耐久

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | posType | int | [ItemPosType枚举](../枚举值/ItemPosType.md) |
    | slotPos | int | 槽位，当posType为ItemPosType.INVENTORY或ItemPosType.ARMOR时才有意义 |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | int | 物品的耐久值 |

- 备注
    - posType设置成serverApi.GetMinecraftEnum().ItemPosType.INVENTORY可替代GetInvItemDurability；posType设置成serverApi.GetMinecraftEnum().ItemPosType.ARMOR可替代GetEquItemDurability；

- 示例

```python
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateItem(playerId)
comp.GetItemDurability(serverApi.GetMinecraftEnum().ItemPosType.INVENTORY, 1)

#替代GetInvItemDurability的方法
comp.GetItemDurability(serverApi.GetMinecraftEnum().ItemPosType.INVENTORY, 1)

#替代GetEquItemDurability的方法
comp.GetItemDurability(serverApi.GetMinecraftEnum().ItemPosType.ARMOR, 1)
```



## GetItemEffectName

<span style="display:inline;color:#7575f9">客户端</span>

method in mod.client.component.itemCompClient.ItemCompClient

- 描述

    获取物品的状态描述，如：§7保护 0§r

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | itemName | str | item的identifier |
    | auxValue | int | 物品的附加值auxValue，默认为不指定auxValue（0） |
    | userData | dict | 物品userData，默认为None |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | str | 物品的状态描述 |

- 示例

```python
# 灾厄旗帜
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateItem(levelId)
comp.GetItemEffectName("minecraft:banner", 15, {'Type': 1})
```



## GetItemFormattedHoverText

<span style="display:inline;color:#7575f9">客户端</span>

method in mod.client.component.itemCompClient.ItemCompClient

- 描述

    获取物品的格式化hover文本，如：§f灾厄旗帜§r

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | itemName | str | item的identifier |
    | auxValue | int | 物品的附加值auxValue，默认为不指定auxValue（0） |
    | showCategory | bool | 是否包括item的类别信息，默认False |
    | userData | dict | 物品userData，默认为None |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | str | 物品的格式化hover文本 |

- 示例

```python
# 灾厄旗帜
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateItem(levelId)
comp.GetItemFormattedHoverText("minecraft:banner", 15, True, {'Type': 1})
```



## GetItemHoverName

<span style="display:inline;color:#7575f9">客户端</span>

method in mod.client.component.itemCompClient.ItemCompClient

- 描述

    获取物品的hover名称，如：灾厄旗帜§r

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | itemName | str | item的identifier |
    | auxValue | int | 物品的附加值auxValue，默认为不指定auxValue（0） |
    | userData | dict | 物品userData，默认为None |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | str | 物品hover名称 |

- 示例

```python
# 灾厄旗帜
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateItem(levelId)
comp.GetItemHoverName("minecraft:banner", 15, {'Type': 1})
```



## GetItemInfoByBlockName

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.itemCompServer.ItemCompServer

- 描述

    通过方块名称及aux值获取物品信息

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | blockName | str | 方块identifier |
    | auxValue | int | aux值 |
    | isLegacy | bool | 方块是否为原生方块，默认为True，即使用旧版aux对应的state |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | dict | <a href="../../../mcguide/20-玩法开发/10-基本概念/1-我的世界基础概念.html#物品信息字典#物品信息字典">物品信息字典</a> |

- 示例

```python
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateItem(levelId)
blockDict = comp.GetItemInfoByBlockName("minecraft:stone")
```



## GetItemLayer

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.itemCompServer.ItemCompServer

- 描述

    获取物品的叠加贴图。物品叠加贴图详见SetItemLayer

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | itemDict | dict | <a href="../../../mcguide/20-玩法开发/10-基本概念/1-我的世界基础概念.html#物品信息字典#物品信息字典">物品信息字典</a> |
    | layer | int | 贴图的层级。可以为-2，-1，1，2，3。 |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | str | 贴图的名字，不存在返回None |

- 示例

```python
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateItem(playerId)
itemDict = comp.GetPlayerItem(serverApi.GetMinecraftEnum().ItemPosType.CARRIED, 0, True)
texture = comp.GetItemLayer(itemDict, 1)
```



## GetItemMaxDurability

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.itemCompServer.ItemCompServer

- 描述

    获取指定槽位的物品耐最大耐久

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | posType | int | [ItemPosType枚举](../枚举值/ItemPosType.md) |
    | slotPos | int | 槽位，当posType为ItemPosType.INVENTORY或ItemPosType.ARMOR时才有意义 |
    | isUserData | bool | 如果为True，则只尝试获取该物品userData特殊设置的值，没有特殊设置过则返回0。如果为False，则会先尝试获取userData中的值，没有的话获取该类物品通用值。 |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | int | 物品的最大耐久 |

- 示例

```python
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateItem(playerId)
comp.GetItemMaxDurability(serverApi.GetMinecraftEnum().ItemPosType.INVENTORY, 1, False)
```



## GetItemTags

<span style="display:inline;color:#ff5555">服务端</span><span style="display:inline;color:#7575f9">客户端</span>

### 服务端接口

<span id="s0"></span>
method in mod.server.component.itemCompServer.ItemCompServer

- 描述

    获取物品在minecraft:tags中定义的tags列表

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | itemName | str | item的identifier |
    | auxValue | int | 物品的附加值auxValue，默认为不指定auxValue（0） |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | list(str) | 物品tags列表 |

- 示例

```python
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateItem(levelId)
comp.GetItemTags("minecraft:apple")
```



### 客户端接口

<span id="c0"></span>
method in mod.client.component.itemCompClient.ItemCompClient

- 描述

    获取物品在minecraft:tags中定义的tags列表

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | itemName | str | item的identifier |
    | auxValue | int | 物品的附加值auxValue，默认为不指定auxValue（0） |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | list(str) | 物品tags列表 |

- 示例

```python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateItem(levelId)
comp.GetItemTags("minecraft:apple")
```



## GetItemTexture

<span style="display:inline;color:#7575f9">客户端</span>

method in mod.client.component.itemCompClient.ItemCompClient

- 描述

    获取item_texture.json中物品的贴图路径。

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | identifier | str | 物品标识符，格式[namespace:name:auxvalue]，auxvalue默认为0 |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | str | 物品的贴图路径 |

- 示例

```python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateItem(levelId)
print(comp.GetItemTexture("mytool:hatchet_1:0"))
```



## GetLoadItems

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.itemCompServer.ItemCompServer

- 描述

    获取已经加载的物品id

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | flag | bool | True获取所有物品，False仅获取注册到创造栏的物品，默认为True |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | list(str) | 物品id列表 |

- 示例

```python
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateItem(levelId)
itemName = comp.GetLoadItems(True)
```



## GetUserDataInEvent

<span style="display:inline;color:#ff5555">服务端</span><span style="display:inline;color:#7575f9">客户端</span>

### 服务端接口

<span id="s0"></span>
method in mod.server.component.itemCompServer.ItemCompServer

- 描述

    使物品相关服务端事件的<a href="../../../mcguide/20-玩法开发/10-基本概念/1-我的世界基础概念.html#物品信息字典#物品信息字典">物品信息字典</a>参数带有userData。在mod初始化时调用即可

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | eventName | str | 引擎事件名 |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | bool | 是否成功 |

- 示例

```python
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateItem(levelId)
# 这样调用之后，PlayerEatFoodServerEvent事件的itemDict参数会带有userData字段
comp.GetUserDataInEvent("PlayerEatFoodServerEvent")
```



### 客户端接口

<span id="c0"></span>
method in mod.client.component.itemCompClient.ItemCompClient

- 描述

    使物品相关客户端事件的<a href="../../../mcguide/20-玩法开发/10-基本概念/1-我的世界基础概念.html#物品信息字典#物品信息字典">物品信息字典</a>参数带有userData。在mod初始化时调用即可

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | eventName | str | 引擎事件名 |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | bool | 是否成功 |

- 示例

```python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateItem(levelId)
# 这样调用之后，ActorAcquiredItemClientEvent事件的itemDict参数会带有userData字段
comp.GetUserDataInEvent("ActorAcquiredItemClientEvent")
```



## LookupItemByName

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.gameCompServer.GameComponentServer

- 描述

    判定指定identifier的物品是否存在

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | itemName | str | 物品的identifier。类似"minecraft:bed"，支持自定义物品 |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | bool | True为对应的物品存在，False为对应物品不存在 |

- 示例

```python
import mod.server.extraServerApi as serverApi
gameComp = serverApi.GetEngineCompFactory().CreateGame(levelId)
exist = gameComp.LookupItemByName("minecraft:bed")
```



## RemoveItemLayer

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.itemCompServer.ItemCompServer

- 描述

    移除物品的叠加贴图。物品叠加贴图详见SetItemLayer

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | itemDict | dict | <a href="../../../mcguide/20-玩法开发/10-基本概念/1-我的世界基础概念.html#物品信息字典#物品信息字典">物品信息字典</a> |
    | layer | int | 贴图的层级。可以为-2，-1，1，2，3。 |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | bool | 是否成功 |

- 示例

```python
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateItem(playerId)
itemDict = comp.GetPlayerItem(serverApi.GetMinecraftEnum().ItemPosType.CARRIED, 0, True)
success = comp.RemoveItemLayer(itemDict, 1)
if success:
    comp.SpawnItemToPlayerCarried(itemDict, playerId)
```



## SetAttackDamage

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.itemCompServer.ItemCompServer

- 描述

     设置物品的攻击伤害值

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | itemDict | dict | <a href="../../../mcguide/20-玩法开发/10-基本概念/1-我的世界基础概念.html#物品信息字典#物品信息字典">物品信息字典</a> |
    | attackDamage | int | 攻击伤害值 |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | bool | 设置是否成功 |

- 示例

```python
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateItem(playerId)
itemDict = comp.GetPlayerItem(serverApi.GetMinecraftEnum().ItemPosType.CARRIED, 0, True)
success = comp.SetAttackDamage(itemDict, 5)
if success:
    comp.SpawnItemToPlayerCarried(itemDict, playerId)
```



## SetCompassEntity

<span style="display:inline;color:#7575f9">客户端</span>

method in mod.client.component.itemCompClient.ItemCompClient

- 描述

    设置指南针朝向的实体

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | entityId | str | 实体id |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | bool | 是否设置成功 |

- 示例

```python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateItem(playerId)
comp.SetCompassEntity(entityId)
```



## SetCompassTarget

<span style="display:inline;color:#7575f9">客户端</span>

method in mod.client.component.itemCompClient.ItemCompClient

- 描述

    设置指南针的朝向位置

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | x | int | 方块x坐标 |
    | y | int | 方块y坐标 |
    | z | int | 方块z坐标 |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | bool | 是否设置成功 |

- 示例

```python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateItem(playerId)
comp.SetCompassTarget(x,y,z)
```



## SetCustomName

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.itemCompServer.ItemCompServer

- 描述

    设置物品的自定义名称，与使用铁砧重命名一致

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | itemDict | dict | <a href="../../../mcguide/20-玩法开发/10-基本概念/1-我的世界基础概念.html#物品信息字典#物品信息字典">物品信息字典</a> |
    | name | str | 物品名称。支持unicode |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | bool | 设置是否成功 |

- 示例

```python
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateItem(playerId)
itemDict = comp.GetPlayerItem(serverApi.GetMinecraftEnum().ItemPosType.CARRIED, 0, True)
comp.SetCustomName(itemDict, '史蒂夫')
comp.SpawnItemToPlayerCarried(itemDict, playerId)
```



## SetItemDefenceAngle

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.itemCompServer.ItemCompServer

- 描述

    设置盾牌物品的抵挡角度范围

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | posType | int | [ItemPosType枚举](../枚举值/ItemPosType.md) |
    | slotPos | int | 槽位 |
    | angleLeft | float | 左边的范围，不想设置左范围传None,取值范围是[-180,180] |
    | angleRight | float | 右边的范围，不想设置右范围传None,取值范围是[-180,180],且angleLeft<angleRight |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | bool | 是否设置成功 |

- 备注
    - 当设置的物品不是盾牌物品时，返回False；原生盾牌会返回True但是仍然走原生的逻辑

- 示例

```python
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateItem(playerId)
comp.SetItemDefenceAngle(serverApi.GetMinecraftEnum().ItemPosType.INVENTORY, 0, -60, 70)
```



## SetItemDurability

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.itemCompServer.ItemCompServer

- 描述

    设置物品的耐久值

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | posType | int | [ItemPosType枚举](../枚举值/ItemPosType.md) |
    | slotPos | int | 槽位，当posType为ItemPosType.INVENTORY或ItemPosType.ARMOR时才有意义 |
    | durability | int | 耐久值 |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | bool | 设置结果 |

- 备注
    - 在使用物品事件中调用这个接口时，建议使用AddTimer延迟一下，不然接口设置可能会失效
    - 设置的耐久值超过物品的最大耐久值时，使用最大耐久值；最小耐久值为0。
    - posType设置成serverApi.GetMinecraftEnum().ItemPosType.INVENTORY时可以代替SetInvItemDurability；posType设置成serverApi.GetMinecraftEnum().ItemPosType.ARMOR时可以代替SetEquItemDurability；

- 示例

```python
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateItem(playerId)
comp.SetItemDurability(serverApi.GetMinecraftEnum().ItemPosType.INVENTORY, 0, 5)

#替代SetInvItemDurability的方法
comp.SetItemDurability(serverApi.GetMinecraftEnum().ItemPosType.INVENTORY, 0, 5)
#替代SetEquItemDurability的方法
comp.SetItemDurability(serverApi.GetMinecraftEnum().ItemPosType.ARMOR, 0, 5)
```



## SetItemLayer

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.itemCompServer.ItemCompServer

- 描述

    设置物品的叠加贴图，可以在物品的上层与下层叠加自定义贴图。具体使用可参考CustomItemsMod示例。

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | itemDict | dict | <a href="../../../mcguide/20-玩法开发/10-基本概念/1-我的世界基础概念.html#物品信息字典#物品信息字典">物品信息字典</a> |
    | layer | int | 贴图的层级。可以为-2，-1，1，2，3。负数层级显示在物品下方，正数的层级显示在物品上方。层级大的显示在层级小的上方。 |
    | texture | str | 贴图的名字，对应item_texture.json中的key。 |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | bool | 设置是否成功 |

- 备注
    - 如果需要在自定义ui中显示叠加贴图，需要在您的物品渲染控件下添加top_layer_3，top_layer_2，top_layer_1，bottom_layer_1，bottom_layer_2共5个图片控件，即可使用SetUiItem显示叠加贴图。可参考CustomFurnaceMod示例
        ```json
        "customItemLayer@common.item_renderer_additional_layer": {
            "bindings": [
                {
                    "binding_name": "#visible",
                    "binding_condition": "always"
                },
                {
                    "binding_name": "#uv",
                    "binding_condition": "always_when_visible"
                },
                {
                    "binding_name": "#uv_size",
                    "binding_condition": "always_when_visible"
                },
                {
                    "binding_name": "#texture",
                    "binding_condition": "always_when_visible"
                }
            ]
        },
        "itemImg" : {
            "anchor_from" : "center",
            "anchor_to" : "center",
            "controls" : [
                {
                    "top_layer_3@neteaseCommonUI.customItemLayer": {
                        "$item_renderer_additional_layer_layer": 3
                    }
                },
                {
                    "top_layer_2@neteaseCommonUI.customItemLayer": {
                        "$item_renderer_additional_layer_layer": 2
                    }
                },
                {
                    "top_layer_1@neteaseCommonUI.customItemLayer": {
                        "$item_renderer_additional_layer_layer": 1
                    }
                },
                {
                    "bottom_layer_1@neteaseCommonUI.customItemLayer": {
                        "$item_renderer_additional_layer_layer": -1
                    }
                },
                {
                    "bottom_layer_2@neteaseCommonUI.customItemLayer": {
                        "$item_renderer_additional_layer_layer": -2
                    }
                },
                {
                "itemNum@neteaseCommonUI.itemNum" : {}
                }
            ],
            "layer" : 3,
            "offset" : [ 0, 0 ],
            "renderer" : "inventory_item_renderer",
            "size" : [ 24, 24 ],
            "type" : "custom",
            "visible" : true
        }
        ```
    - 需要为5层叠加贴图预留ui层级，让他可以显示在背包背景之上，物品数量之下。例如在CustomFurnaceMod示例中，itemBtn中的default/hover/pressed贴图的层级为2，物品渲染控件itemImg的层级为5，五个叠加贴图的层级分别为3/4/6/7/8，selectedImg的层级为9，itemNum的层级为10，durabilityBar的层级为11。

- 示例

```python
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateItem(playerId)
itemDict = comp.GetPlayerItem(serverApi.GetMinecraftEnum().ItemPosType.CARRIED, 0, True)
success = comp.SetItemLayer(itemDict, 1, 'wooden_door')
if success:
    comp.SpawnItemToPlayerCarried(itemDict, playerId)
```



## SetItemMaxDurability

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.itemCompServer.ItemCompServer

- 描述

    设置物品的最大耐久值

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | posType | int | [ItemPosType枚举](../枚举值/ItemPosType.md) |
    | slotPos | int | 槽位，当posType为ItemPosType.INVENTORY或ItemPosType.ARMOR时才有意义 |
    | maxDurability | int | 最大耐久值，可设为0~32767 |
    | isUserData | bool | 如果为True，则该设置只对指定物品生效，如果为False，则对同一类所有物品生效 |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | bool | 设置结果 |

- 备注
    - 若物品堆叠数量大于1时，耐久度的变更对整一叠的物品生效。并且耐久度为0后，每次消耗耐久度的行为会使数量减一
    - 为物品设置的userData最大耐久度在计算时优先级最高，userData数据存盘。
    - 在砂轮或背包合并时，若两个物品都有userData，只会保留其中一个。在铁砧中修复时，最大耐久取被修复物品的耐久。
    - 当最大耐久值被更改时，当前耐久度也会按比例修复。
    - 对同一类所有物品设置的最大耐久度不存盘，每次重启世界都会重新初始化，可以通过对应item json的`minecraft:max_damage`组件设置初始化最大耐久度
    - 如果设置的是背包物品，当slot值为-1时，设置左手物品的最大耐久值

- 示例

```python
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateItem(playerId)
comp.SetItemMaxDurability(serverApi.GetMinecraftEnum().ItemPosType.INVENTORY, 0, 5, False)
```



## SetItemTierLevel

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.itemCompServer.ItemCompServer

- 描述

     设置工具类物品的挖掘等级

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | itemDict | dict | <a href="../../../mcguide/20-玩法开发/10-基本概念/1-我的世界基础概念.html#物品信息字典#物品信息字典">物品信息字典</a> |
    | level | int | 挖掘等级 |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | bool | 设置是否成功 |

- 备注
    - 对于不总是可以破坏的方块（包括方块材质为Stone，Metal，TopSnow，Snow，Web），需要使用不同挖掘等级（level）的工具才能破坏并产生掉落物。
        | level | 类型 |
        | ----- | ---- |
        | 0     | 木   |
        | 1     | 石   |
        | 2     | 铁   |
        | 3     | 钻石 |
        | 4     | 下界 |
    - 剑和剪刀都可以对蜘蛛网进行破坏并产生掉落物；
        铲可以对雪和顶层雪进行破坏并产生掉落物；
        镐是否可以破坏判断：
        1）对于黑曜石、下界类方块、远古残骸，需要Level大于等于3的镐才能破坏并产生掉落物；
        2）对于钻石块、钻石矿石、绿宝石块、绿宝石矿石、金块、金矿石、红石矿石、发光的红石矿石，需要Level大于等于2的镐才能破坏并产生掉落物；
        3）对于铁块、铁矿石、青金石块、青金石矿石，需要Level大于等于1的镐才能破坏并产生掉落物；
        4）对于其他Stone和Metal材质的方块，需要Level大于等于0的镐才能破坏并产生掉落物。

- 示例

```python
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateItem(playerId)
itemDict = comp.GetPlayerItem(serverApi.GetMinecraftEnum().ItemPosType.CARRIED, 0, True)
success = comp.SetItemTierLevel(itemDict, 5)
if success:
    comp.SpawnItemToPlayerCarried(itemDict, playerId)
```



## SetItemTierSpeed

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.itemCompServer.ItemCompServer

- 描述

     设置工具类物品的挖掘速度(可通过userData中的ModTierSpeed获取挖掘速度)

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | itemDict | dict | <a href="../../../mcguide/20-玩法开发/10-基本概念/1-我的世界基础概念.html#物品信息字典#物品信息字典">物品信息字典</a> |
    | speed | float | 挖掘速度 |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | bool | 设置是否成功 |

- 示例

```python
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateItem(playerId)
itemDict = comp.GetPlayerItem(serverApi.GetMinecraftEnum().ItemPosType.CARRIED, 0, True)
success = comp.SetItemTierSpeed(itemDict, 32)
if success:
    comp.SpawnItemToPlayerCarried(itemDict, playerId)
```



## SetMaxStackSize

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.itemCompServer.ItemCompServer

- 描述

     设置物品的最大堆叠数量（存档）

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | itemDict | dict | <a href="../../../mcguide/20-玩法开发/10-基本概念/1-我的世界基础概念.html#物品信息字典#物品信息字典">物品信息字典</a> |
    | maxStackSize | int | 最大堆叠数量，不能超过64，如果该值小于物品的堆叠数量，会返回失败 |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | bool | 设置是否成功 |

- 示例

```python
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateItem(playerId)
itemDict = comp.GetPlayerItem(serverApi.GetMinecraftEnum().ItemPosType.CARRIED, 0, True)
success = comp.SetMaxStackSize(itemDict, 32)
if success:
    comp.SpawnItemToPlayerCarried(itemDict, playerId)
```



## SetShearsDestoryBlockSpeed

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.itemCompServer.ItemCompServer

- 描述

     设置剪刀对某一方块的破坏速度

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | blockName | str | 方块名称,包含命名空间 |
    | speed | float | 破坏速度 |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | bool | 设置是否成功 |

- 备注
    - 设置的速度最终会加上剪刀的附魔：效率计算
    - 原版剪刀对蜘蛛网的破坏速度为15，羊毛的破坏速度为5，也可以用该接口重写对这两个方块的破坏速度
    - 设置的速度必须大于1，否则该接口返回False

- 示例

```python
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateItem(entityId)
comp.SetShearsDestoryBlockSpeed("minecraft:obsidian", 100)
```