Skip to content

2.12版本物品id变更

简介

2.12版本与2.11版本相比,有部分物品的名称发生了变更,取消了附加值,例如橙色羊毛从minecraft:wool 1变为minecraft:orange_wool;云杉原木从minecraft:log 1变为minecraft:spruce_log。

处理方法

在ModSDK的接口与事件中,我们针对上述情况做了以下处理:

  1. 对于返回物品信息字典的接口与事件:

    newItemName及newAuxValue返回新版名称与附加值。

    原字段itemName及auxValue返回旧版名称与附加值。

  2. 对于接受物品信息字典的接口与事件:

    当字典存在newItemName及newAuxValue时,使用这两个字段。

    不存在时,使用旧字段itemName及auxValue。

注意事项

  • 通过附加值获取获取方块状态接口没有做兼容,例如GetBlockAuxValueFromStates、GetBlockStatesFromAuxValue、GetBlockStates、SetBlockStates,如果您的组件对此有依赖,则需要对这次的改动自行做兼容处理。

  • 开发完成或正在开发的组件,建议统一采用newItemName及newAuxValue字段,也不要新旧字段混用。

  • 某些写法可能会失效,例如

    python
    # 获取itemDict,然后在他基础上修改itemName或auxValue后再用来生成
    itemdict = GetPlayerItem()
    itemdict['itemName'] = 'xxx'
    itemdict['auxValue'] = itemdict['auxValue']+1
    SpawnItemToPlayerInv(itemdict)

    因为GetPlayerItem返回的itemDict含有新字段,再传入SpawnItemToPlayerInv时,会读取新字段生成物品,因此对原字段的修改无效。

物品名称变更表

以下为2.12版本变更了名称的物品列表。表格内的名称省略了minecraft命名空间。

中文名称旧命名旧附加值新命名
白色羊毛wool0white_wool
橙色羊毛wool1orange_wool
品红色羊毛wool2magenta_wool
淡蓝色羊毛wool3light_blue_wool
黄色羊毛wool4yellow_wool
黄绿色羊毛wool5lime_wool
粉红色羊毛wool6pink_wool
灰色羊毛wool7gray_wool
淡灰色羊毛wool8light_gray_wool
青色羊毛wool9cyan_wool
紫色羊毛wool10purple_wool
蓝色羊毛wool11blue_wool
棕色羊毛wool12brown_wool
绿色羊毛wool13green_wool
红色羊毛wool14red_wool
黑色羊毛wool15black_wool
橡木原木log0oak_log
云杉原木log1spruce_log
白桦原木log2birch_log
丛林原木log3jungle_log
金合欢原木log20acacia_log
深色橡木原木log21dark_oak_log
橡木栅栏fence0oak_fence
云杉木栅栏fence1spruce_fence
白桦木栅栏fence2birch_fence
丛林木栅栏fence3jungle_fence
金合欢木栅栏fence4acacia_fence
深色橡木栅栏fence5dark_oak_fence
管珊瑚coral0tube_coral
脑纹珊瑚coral1brain_coral
气泡珊瑚coral2bubble_coral
火珊瑚coral3fire_coral
鹿角珊瑚coral4horn_coral
失活的管珊瑚coral8dead_tube_coral
失活的脑纹珊瑚coral9dead_brain_coral
失活的气泡珊瑚coral10dead_bubble_coral
失活的火珊瑚coral11dead_fire_coral
失活的鹿角珊瑚coral12dead_horn_coral
白色地毯carpet0white_carpet
橙色地毯carpet1orange_carpet
品红色地毯carpet2magenta_carpet
淡蓝色地毯carpet3light_blue_carpet
黄色地毯carpet4yellow_carpet
黄绿色地毯carpet5lime_carpet
粉红色地毯carpet6pink_carpet
灰色地毯carpet7gray_carpet
淡灰色地毯carpet8light_gray_carpet
青色地毯carpet9cyan_carpet
紫色地毯carpet10purple_carpet
蓝色地毯carpet11blue_carpet
棕色地毯carpet12brown_carpet
绿色地毯carpet13green_carpet
红色地毯carpet14red_carpet
黑色地毯carpet15black_carpet
白色潜影盒shulker_box0white_shulker_box
橙色潜影盒shulker_box1orange_shulker_box
品红色潜影盒shulker_box2magenta_shulker_box
淡蓝色潜影盒shulker_box3light_blue_shulker_box
黄色潜影盒shulker_box4yellow_shulker_box
黄绿色潜影盒shulker_box5lime_shulker_box
粉红色潜影盒shulker_box6pink_shulker_box
灰色潜影盒shulker_box7gray_shulker_box
淡灰色潜影盒shulker_box8light_gray_shulker_box
青色潜影盒shulker_box9cyan_shulker_box
紫色潜影盒shulker_box10purple_shulker_box
蓝色潜影盒shulker_box11blue_shulker_box
棕色潜影盒shulker_box12brown_shulker_box
绿色潜影盒shulker_box13green_shulker_box
红色潜影盒shulker_box14red_shulker_box
黑色潜影盒shulker_box15black_shulker_box
白色混凝土concrete0white_concrete
橙色混凝土concrete1orange_concrete
品红色混凝土concrete2magenta_concrete
淡蓝色混凝土concrete3light_blue_concrete
黄色混凝土concrete4yellow_concrete
黄绿色混凝土concrete5lime_concrete
粉红色混凝土concrete6pink_concrete
灰色混凝土concrete7gray_concrete
淡灰色混凝土concrete8light_gray_concrete
青色混凝土concrete9cyan_concrete
紫色混凝土concrete10purple_concrete
蓝色混凝土concrete11blue_concrete
棕色混凝土concrete12brown_concrete
绿色混凝土concrete13green_concrete
红色混凝土concrete14red_concrete
黑色混凝土concrete15black_concrete