下载开发工作台 下载课程到本地
[退出]
返回首页

扫一扫关注
开发者QQ频道

扫一扫关注
微信公众号

扫一扫关注
网易大神

扫一扫关注
开发者B站

开发者论坛

问题反馈

登录

1-ModAPI > 接口 > 物品
搜索

# 物品

# 索引

包括物品属性的接口，物品的生成与获取见玩家/背包，实体/背包，方块/容器，物品实体的生成与获取见世界/实体管理

接口
描述
CancelShearsDestoryBlockSpeed 服务端 取消剪刀对某一方块的破坏速度设置
CancelShearsDestoryBlockSpeedAll 服务端 取消剪刀对全部方块的破坏速度设置
ChangeArmorTextures 客户端 修改盔甲在场景中显示和在UI中显示的贴图
ChangeItemTexture 客户端 替换物品的贴图，修改后所有用到该贴图的物品都会被改变，后续创建的此类物品也会被改变。会同时修改物品在UI界面上的显示，手持时候的显示与场景掉落的显示。
GetAllEnchantsInfo 服务端 获取目前已注册的所有附魔信息
GetAllEnchantsInfo 客户端 获取目前已注册的所有附魔信息
GetCustomName 服务端 获取物品的自定义名称，与铁砧修改的名称一致
GetItemBasicInfo 服务端 获取物品的基础信息
GetItemBasicInfo 客户端 获取物品的基础信息
GetItemDefenceAngle 服务端 获取盾牌物品的抵挡角度范围
GetItemDurability 服务端 获取指定槽位的物品耐久
GetItemEffectName 客户端 获取物品的状态描述，如：§7保护 0§r
GetItemFormattedHoverText 客户端 获取物品的格式化hover文本，如：§f灾厄旗帜§r
GetItemHoverName 客户端 获取物品的hover名称，如：灾厄旗帜§r
GetItemLayer 服务端 获取物品的叠加贴图。物品叠加贴图详见SetItemLayer
GetItemMaxDurability 服务端 获取指定槽位的物品耐最大耐久
GetLoadItems 服务端 获取已经加载的物品id
GetUserDataInEvent 服务端 使物品相关服务端事件的物品信息字典参数带有userData。在mod初始化时调用即可
GetUserDataInEvent 客户端 使物品相关客户端事件的物品信息字典参数带有userData。在mod初始化时调用即可
LookupItemByName 服务端 判定指定identifier的物品是否存在
RemoveItemLayer 服务端 移除物品的叠加贴图。物品叠加贴图详见SetItemLayer
SetAttackDamage 服务端 设置物品的攻击伤害值
SetCustomName 服务端 设置物品的自定义名称，与使用铁砧重命名一致
SetItemDefenceAngle 服务端 设置盾牌物品的抵挡角度范围
SetItemDurability 服务端 设置物品的耐久值
SetItemLayer 服务端 设置物品的叠加贴图，可以在物品的上层与下层叠加自定义贴图。具体使用可参考CustomItemsMod示例。
SetItemMaxDurability 服务端 设置物品的最大耐久值
SetItemTierLevel 服务端 设置工具类物品的挖掘等级
SetItemTierSpeed 服务端 设置工具类物品的挖掘速度
SetMaxStackSize 服务端 设置物品的最大堆叠数量（存档）
SetShearsDestoryBlockSpeed 服务端 设置剪刀对某一方块的破坏速度

# CancelShearsDestoryBlockSpeed

服务端

method in mod.server.component.itemCompServer.ItemCompServer

  • 描述

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

  • 参数

    参数名
    数据类型
    		 说明
    blockName str 方块名称,包含命名空间

  • 返回值

    数据类型
    		 说明
    bool 设置是否成功

  • 示例

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

# CancelShearsDestoryBlockSpeedAll

服务端

method in mod.server.component.itemCompServer.ItemCompServer

  • 描述

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

  • 参数

    无

  • 返回值

    数据类型
    		 说明
    bool 设置是否成功

  • 示例

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

# ChangeArmorTextures

客户端

method in mod.client.component.actorRenderCompClient.ActorRenderCompClient

  • 描述

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

  • 参数

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

  • 返回值

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

  • 备注

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

  • 示例

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

客户端

method in mod.client.component.itemCompClient.ItemCompClient

  • 描述

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

  • 参数

    参数名
    数据类型
    		 说明
    identifier str 物品标识符，格式[namespace:name:auxvalue]，auxvalue默认为0
    texturePath str 贴图路径

  • 返回值

    数据类型
    		 说明
    bool 是否修改成功（因为采用延迟加载，此处返回成功不代表贴图路径正确，路径错误会导致渲染时贴图丢失显示异常）

  • 备注

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

  • 示例

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

# GetAllEnchantsInfo

服务端客户端

# 服务端接口

method in mod.server.component.itemCompServer.ItemCompServer

  • 描述

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

  • 参数

    无

  • 返回值

    数据类型
    		 说明
    list(dict) 附魔信息字典附魔信息字典

  • 备注

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

  • 示例

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

# 客户端接口

method in mod.client.component.itemCompClient.ItemCompClient

  • 描述

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

  • 参数

    无

  • 返回值

    数据类型
    		 说明
    list(dict) 附魔信息字典附魔信息字典

  • 备注

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

  • 示例

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

# GetCustomName

服务端

method in mod.server.component.itemCompServer.ItemCompServer

  • 描述

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

  • 参数

    参数名
    数据类型
    		 说明
    itemDict dict 物品信息字典。如果是接口获取的itemDict，应该包含userData，即getUserData应该为True

  • 返回值

    数据类型
    		 说明
    str 自定义名称

  • 示例

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

服务端客户端

# 服务端接口

method in mod.server.component.itemCompServer.ItemCompServer

  • 描述

    获取物品的基础信息

  • 参数

    参数名
    数据类型
    		 说明
    itemName str item的identifier
    auxValue int 物品的附加值auxvalue，默认为0
    isEnchanted bool 是否附魔，默认为False。用于返回的id_aux

  • 返回值

    数据类型
    		 说明
    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 自定义物品类型
      itemTierLevel int 工具等级
      fuelDuration float 燃料时长
      foodNutrition int 食物营养值
      foodSaturation float 食物饱食度
      weaponDamage int 武器攻击力
      armorDefense 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 合金工具

  • 示例

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

# 客户端接口

method in mod.client.component.itemCompClient.ItemCompClient

  • 描述

    获取物品的基础信息

  • 参数

    参数名
    数据类型
    		 说明
    itemName str item的identifier
    auxValue int 物品的附加值auxvalue，默认为0
    isEnchanted bool 是否附魔，默认为False。用于返回的id_aux

  • 返回值

    数据类型
    		 说明
    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 自定义物品类型
      itemTierLevel int 工具等级
      fuelDuration float 燃料时长
      foodNutrition int 食物营养值
      foodSaturation float 食物饱食度
      weaponDamage int 武器攻击力
      armorDefense int 防具防御力
      armorToughness int 防具韧性
      armorKnockbackResistance float 防具击退抗性

    • 部分原版物品较为特殊，获取不到个别字段的返回值 方块类燃料获取不到燃料时长，弓、弩获取不到武器攻击力，蛋糕获取不到营养值和饱食度，马铠获取不到防具防御力，上述物品获取对应字段返回值为0

    • id_aux字段的示例： 在ui中添加一个inventory_item_renderer控件以及#item_id_aux的绑定

      "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中添加绑定回调

      @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 合金工具

  • 示例

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

# GetItemDefenceAngle

服务端

method in mod.server.component.itemCompServer.ItemCompServer

  • 描述

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

  • 参数

    参数名
    数据类型
    		 说明
    posType int ItemPosType枚举
    slotPos int 槽位

  • 返回值

    数据类型
    		 说明
    list(float) 角度范围

  • 备注

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

  • 示例

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

# GetItemDurability

服务端

method in mod.server.component.itemCompServer.ItemCompServer

  • 描述

    获取指定槽位的物品耐久

  • 参数

    参数名
    数据类型
    		 说明
    posType int ItemPosType枚举
    slotPos int 槽位，当posType为ItemPosType.INVENTORY或ItemPosType.ARMOR时才有意义

  • 返回值

    数据类型
    		 说明
    int 物品的耐久值

  • 备注

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

  • 示例

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

客户端

method in mod.client.component.itemCompClient.ItemCompClient

  • 描述

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

  • 参数

    参数名
    数据类型
    		 说明
    itemName str item的identifier
    auxValue int 物品的附加值auxValue，默认为不指定auxValue（0）
    userData dict 物品userData，默认为None

  • 返回值

    数据类型
    		 说明
    str 物品的状态描述

  • 示例

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

# GetItemFormattedHoverText

客户端

method in mod.client.component.itemCompClient.ItemCompClient

  • 描述

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

  • 参数

    参数名
    数据类型
    		 说明
    itemName str item的identifier
    auxValue int 物品的附加值auxValue，默认为不指定auxValue（0）
    showCategory bool 是否包括item的类别信息，默认False
    userData dict 物品userData，默认为None

  • 返回值

    数据类型
    		 说明
    str 物品的格式化hover文本

  • 示例

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

# GetItemHoverName

客户端

method in mod.client.component.itemCompClient.ItemCompClient

  • 描述

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

  • 参数

    参数名
    数据类型
    		 说明
    itemName str item的identifier
    auxValue int 物品的附加值auxValue，默认为不指定auxValue（0）
    userData dict 物品userData，默认为None

  • 返回值

    数据类型
    		 说明
    str 物品hover名称

  • 示例

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

# GetItemLayer

服务端

method in mod.server.component.itemCompServer.ItemCompServer

  • 描述

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

  • 参数

    参数名
    数据类型
    		 说明
    itemDict dict 物品信息字典
    layer int 贴图的层级。可以为-2，-1，1，2，3。

  • 返回值

    数据类型
    		 说明
    str 贴图的名字，不存在返回None

  • 示例

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

服务端

method in mod.server.component.itemCompServer.ItemCompServer

  • 描述

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

  • 参数

    参数名
    数据类型
    		 说明
    posType int ItemPosType枚举
    slotPos int 槽位，当posType为ItemPosType.INVENTORY或ItemPosType.ARMOR时才有意义
    isUserData bool 如果为True，则只尝试获取该物品userData特殊设置的值，没有特殊设置过则返回0。如果为False，则会先尝试获取userData中的值，没有的话获取该类物品通用值。

  • 返回值

    数据类型
    		 说明
    int 物品的最大耐久

  • 示例

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

# GetLoadItems

服务端

method in mod.server.component.itemCompServer.ItemCompServer

  • 描述

    获取已经加载的物品id

  • 参数

    参数名
    数据类型
    		 说明
    flag bool True获取所有物品，False仅获取注册到创造栏的物品，默认为True

  • 返回值

    数据类型
    		 说明
    list(str) 物品id列表

  • 示例

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

# GetUserDataInEvent

服务端客户端

# 服务端接口

method in mod.server.component.itemCompServer.ItemCompServer

  • 描述

    使物品相关服务端事件的物品信息字典参数带有userData。在mod初始化时调用即可

  • 参数

    参数名
    数据类型
    		 说明
    eventName str 引擎事件名

  • 返回值

    数据类型
    		 说明
    bool 是否成功

  • 示例

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

# 客户端接口

method in mod.client.component.itemCompClient.ItemCompClient

  • 描述

    使物品相关客户端事件的物品信息字典参数带有userData。在mod初始化时调用即可

  • 参数

    参数名
    数据类型
    		 说明
    eventName str 引擎事件名

  • 返回值

    数据类型
    		 说明
    bool 是否成功

  • 示例

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

# LookupItemByName

服务端

method in mod.server.component.gameCompServer.GameComponentServer

  • 描述

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

  • 参数

    参数名
    数据类型
    		 说明
    itemName str 物品的identifier。类似"minecraft:bed"，支持自定义物品

  • 返回值

    数据类型
    		 说明
    bool True为对应的物品存在，False为对应物品不存在

  • 示例

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

# RemoveItemLayer

服务端

method in mod.server.component.itemCompServer.ItemCompServer

  • 描述

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

  • 参数

    参数名
    数据类型
    		 说明
    itemDict dict 物品信息字典
    layer int 贴图的层级。可以为-2，-1，1，2，3。

  • 返回值

    数据类型
    		 说明
    bool 是否成功

  • 示例

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

服务端

method in mod.server.component.itemCompServer.ItemCompServer

  • 描述

    设置物品的攻击伤害值

  • 参数

    参数名
    数据类型
    		 说明
    itemDict dict 物品信息字典
    attackDamage int 攻击伤害值

  • 返回值

    数据类型
    		 说明
    bool 设置是否成功

  • 示例

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)

# SetCustomName

服务端

method in mod.server.component.itemCompServer.ItemCompServer

  • 描述

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

  • 参数

    参数名
    数据类型
    		 说明
    itemDict dict 物品信息字典
    name str 物品名称。支持unicode

  • 返回值

    数据类型
    		 说明
    bool 设置是否成功

  • 示例

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

服务端

method in mod.server.component.itemCompServer.ItemCompServer

  • 描述

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

  • 参数

    参数名
    数据类型
    		 说明
    posType int ItemPosType枚举
    slotPos int 槽位
    angleLeft float 左边的范围，不想设置左范围传None,取值范围是[-180,180]
    angleRight float 右边的范围，不想设置右范围传None,取值范围是[-180,180],且angleLeft<angleRight

  • 返回值

    数据类型
    		 说明
    bool 是否设置成功

  • 备注

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

  • 示例

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

# SetItemDurability

服务端

method in mod.server.component.itemCompServer.ItemCompServer

  • 描述

    设置物品的耐久值

  • 参数

    参数名
    数据类型
    		 说明
    posType int ItemPosType枚举
    slotPos int 槽位，当posType为ItemPosType.INVENTORY或ItemPosType.ARMOR时才有意义
    durability int 耐久值

  • 返回值

    数据类型
    		 说明
    bool 设置结果

  • 备注

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

  • 示例

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

服务端

method in mod.server.component.itemCompServer.ItemCompServer

  • 描述

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

  • 参数

    参数名
    数据类型
    		 说明
    itemDict dict 物品信息字典
    layer int 贴图的层级。可以为-2，-1，1，2，3。负数层级显示在物品下方，正数的层级显示在物品上方。层级大的显示在层级小的上方。
    texture str 贴图的名字，对应item_texture.json中的key。

  • 返回值

    数据类型
    		 说明
    bool 设置是否成功

  • 备注

    • 如果需要在自定义ui中显示叠加贴图，需要在您的物品渲染控件下添加top_layer_3，top_layer_2，top_layer_1，bottom_layer_1，bottom_layer_2共5个图片控件，即可使用SetUiItem显示叠加贴图。可参考CustomFurnaceMod示例
      "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。

  • 示例

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

服务端

method in mod.server.component.itemCompServer.ItemCompServer

  • 描述

    设置物品的最大耐久值

  • 参数

    参数名
    数据类型
    		 说明
    posType int ItemPosType枚举
    slotPos int 槽位，当posType为ItemPosType.INVENTORY或ItemPosType.ARMOR时才有意义
    maxDurability int 最大耐久值，可设为0~32767
    isUserData bool 如果为True，则该设置只对指定物品生效，如果为False，则对同一类所有物品生效

  • 返回值

    数据类型
    		 说明
    bool 设置结果

  • 备注

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

  • 示例

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

# SetItemTierLevel

服务端

method in mod.server.component.itemCompServer.ItemCompServer

  • 描述

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

  • 参数

    参数名
    数据类型
    		 说明
    itemDict dict 物品信息字典
    level int 挖掘等级

  • 返回值

    数据类型
    		 说明
    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的镐才能破坏并产生掉落物。

  • 示例

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

服务端

method in mod.server.component.itemCompServer.ItemCompServer

  • 描述

    设置工具类物品的挖掘速度

  • 参数

    参数名
    数据类型
    		 说明
    itemDict dict 物品信息字典
    speed float 挖掘速度

  • 返回值

    数据类型
    		 说明
    bool 设置是否成功

  • 示例

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

服务端

method in mod.server.component.itemCompServer.ItemCompServer

  • 描述

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

  • 参数

    参数名
    数据类型
    		 说明
    itemDict dict 物品信息字典
    maxStackSize int 最大堆叠数量，不能超过64，如果该值小于物品的堆叠数量，会返回失败

  • 返回值

    数据类型
    		 说明
    bool 设置是否成功

  • 示例

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

服务端

method in mod.server.component.itemCompServer.ItemCompServer

  • 描述

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

  • 参数

    参数名
    数据类型
    		 说明
    blockName str 方块名称,包含命名空间
    speed float 破坏速度

  • 返回值

    数据类型
    		 说明
    bool 设置是否成功

  • 备注

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

  • 示例

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

← 索引 →

CancelShearsDestoryBlockSpeed

CancelShearsDestoryBlockSpeedAll

ChangeArmorTextures

ChangeItemTexture

GetAllEnchantsInfo

服务端接口

客户端接口

GetCustomName

GetItemBasicInfo

服务端接口

客户端接口

GetItemDefenceAngle

GetItemDurability

GetItemEffectName

GetItemFormattedHoverText

GetItemHoverName

GetItemLayer

GetItemMaxDurability

GetLoadItems

GetUserDataInEvent

服务端接口

客户端接口

LookupItemByName

RemoveItemLayer

SetAttackDamage

SetCustomName

SetItemDefenceAngle

SetItemDurability

SetItemLayer

SetItemMaxDurability

SetItemTierLevel

SetItemTierSpeed

SetMaxStackSize

SetShearsDestoryBlockSpeed