2.12版本物品id变更 
简介 
2.12版本与2.11版本相比,有部分物品的名称发生了变更,取消了附加值,例如橙色羊毛从minecraft:wool 1变为minecraft:orange_wool;云杉原木从minecraft:log 1变为minecraft:spruce_log。
处理方法 
在ModSDK的接口与事件中,我们针对上述情况做了以下处理:
对于返回物品信息字典的接口与事件:
newItemName及newAuxValue返回新版名称与附加值。
原字段itemName及auxValue返回旧版名称与附加值。
对于接受物品信息字典的接口与事件:
当字典存在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命名空间。
| 中文名称 | 旧命名 | 旧附加值 | 新命名 | 
|---|---|---|---|
| 白色羊毛 | wool | 0 | white_wool | 
| 橙色羊毛 | wool | 1 | orange_wool | 
| 品红色羊毛 | wool | 2 | magenta_wool | 
| 淡蓝色羊毛 | wool | 3 | light_blue_wool | 
| 黄色羊毛 | wool | 4 | yellow_wool | 
| 黄绿色羊毛 | wool | 5 | lime_wool | 
| 粉红色羊毛 | wool | 6 | pink_wool | 
| 灰色羊毛 | wool | 7 | gray_wool | 
| 淡灰色羊毛 | wool | 8 | light_gray_wool | 
| 青色羊毛 | wool | 9 | cyan_wool | 
| 紫色羊毛 | wool | 10 | purple_wool | 
| 蓝色羊毛 | wool | 11 | blue_wool | 
| 棕色羊毛 | wool | 12 | brown_wool | 
| 绿色羊毛 | wool | 13 | green_wool | 
| 红色羊毛 | wool | 14 | red_wool | 
| 黑色羊毛 | wool | 15 | black_wool | 
| 橡木原木 | log | 0 | oak_log | 
| 云杉原木 | log | 1 | spruce_log | 
| 白桦原木 | log | 2 | birch_log | 
| 丛林原木 | log | 3 | jungle_log | 
| 金合欢原木 | log2 | 0 | acacia_log | 
| 深色橡木原木 | log2 | 1 | dark_oak_log | 
| 橡木栅栏 | fence | 0 | oak_fence | 
| 云杉木栅栏 | fence | 1 | spruce_fence | 
| 白桦木栅栏 | fence | 2 | birch_fence | 
| 丛林木栅栏 | fence | 3 | jungle_fence | 
| 金合欢木栅栏 | fence | 4 | acacia_fence | 
| 深色橡木栅栏 | fence | 5 | dark_oak_fence | 
| 管珊瑚 | coral | 0 | tube_coral | 
| 脑纹珊瑚 | coral | 1 | brain_coral | 
| 气泡珊瑚 | coral | 2 | bubble_coral | 
| 火珊瑚 | coral | 3 | fire_coral | 
| 鹿角珊瑚 | coral | 4 | horn_coral | 
| 失活的管珊瑚 | coral | 8 | dead_tube_coral | 
| 失活的脑纹珊瑚 | coral | 9 | dead_brain_coral | 
| 失活的气泡珊瑚 | coral | 10 | dead_bubble_coral | 
| 失活的火珊瑚 | coral | 11 | dead_fire_coral | 
| 失活的鹿角珊瑚 | coral | 12 | dead_horn_coral | 
| 白色地毯 | carpet | 0 | white_carpet | 
| 橙色地毯 | carpet | 1 | orange_carpet | 
| 品红色地毯 | carpet | 2 | magenta_carpet | 
| 淡蓝色地毯 | carpet | 3 | light_blue_carpet | 
| 黄色地毯 | carpet | 4 | yellow_carpet | 
| 黄绿色地毯 | carpet | 5 | lime_carpet | 
| 粉红色地毯 | carpet | 6 | pink_carpet | 
| 灰色地毯 | carpet | 7 | gray_carpet | 
| 淡灰色地毯 | carpet | 8 | light_gray_carpet | 
| 青色地毯 | carpet | 9 | cyan_carpet | 
| 紫色地毯 | carpet | 10 | purple_carpet | 
| 蓝色地毯 | carpet | 11 | blue_carpet | 
| 棕色地毯 | carpet | 12 | brown_carpet | 
| 绿色地毯 | carpet | 13 | green_carpet | 
| 红色地毯 | carpet | 14 | red_carpet | 
| 黑色地毯 | carpet | 15 | black_carpet | 
| 白色潜影盒 | shulker_box | 0 | white_shulker_box | 
| 橙色潜影盒 | shulker_box | 1 | orange_shulker_box | 
| 品红色潜影盒 | shulker_box | 2 | magenta_shulker_box | 
| 淡蓝色潜影盒 | shulker_box | 3 | light_blue_shulker_box | 
| 黄色潜影盒 | shulker_box | 4 | yellow_shulker_box | 
| 黄绿色潜影盒 | shulker_box | 5 | lime_shulker_box | 
| 粉红色潜影盒 | shulker_box | 6 | pink_shulker_box | 
| 灰色潜影盒 | shulker_box | 7 | gray_shulker_box | 
| 淡灰色潜影盒 | shulker_box | 8 | light_gray_shulker_box | 
| 青色潜影盒 | shulker_box | 9 | cyan_shulker_box | 
| 紫色潜影盒 | shulker_box | 10 | purple_shulker_box | 
| 蓝色潜影盒 | shulker_box | 11 | blue_shulker_box | 
| 棕色潜影盒 | shulker_box | 12 | brown_shulker_box | 
| 绿色潜影盒 | shulker_box | 13 | green_shulker_box | 
| 红色潜影盒 | shulker_box | 14 | red_shulker_box | 
| 黑色潜影盒 | shulker_box | 15 | black_shulker_box | 
| 白色混凝土 | concrete | 0 | white_concrete | 
| 橙色混凝土 | concrete | 1 | orange_concrete | 
| 品红色混凝土 | concrete | 2 | magenta_concrete | 
| 淡蓝色混凝土 | concrete | 3 | light_blue_concrete | 
| 黄色混凝土 | concrete | 4 | yellow_concrete | 
| 黄绿色混凝土 | concrete | 5 | lime_concrete | 
| 粉红色混凝土 | concrete | 6 | pink_concrete | 
| 灰色混凝土 | concrete | 7 | gray_concrete | 
| 淡灰色混凝土 | concrete | 8 | light_gray_concrete | 
| 青色混凝土 | concrete | 9 | cyan_concrete | 
| 紫色混凝土 | concrete | 10 | purple_concrete | 
| 蓝色混凝土 | concrete | 11 | blue_concrete | 
| 棕色混凝土 | concrete | 12 | brown_concrete | 
| 绿色混凝土 | concrete | 13 | green_concrete | 
| 红色混凝土 | concrete | 14 | red_concrete | 
| 黑色混凝土 | concrete | 15 | black_concrete |