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字段，也不要新旧字段混用。

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

  # 获取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