# 3.4版本物品id变更

## 简介

微软在1.21.00继续修改了部分方块ID，取消了附加值，相关链接请参阅[基岩版扁平化](https://zh.minecraft.wiki/w/%E5%AE%98%E6%96%B9%E9%A1%B5%E9%9D%A2/%E5%9F%BA%E5%B2%A9%E7%89%88%E6%89%81%E5%B9%B3%E5%8C%96)，请开发者注意适配。

## 处理方法

在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时，会读取新字段生成物品，因此对原字段的修改无效。

## 物品名称变更表

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

| 中文名称 | 旧命名 | 旧附加值 | 新命名 |
| :------- | ------ | -------- | ------ |
| 草方块 | grass | 0 | grass_block |
| 橡树树苗 | sapling | 0 | oak_sapling |
| 云杉树苗 | sapling | 1 | spruce_sapling |
| 白桦树苗 | sapling | 2 | birch_sapling |
| 丛林树苗 | sapling | 3 | jungle_sapling |
| 金合欢树苗 | sapling | 4 | acacia_sapling |
| 深色橡树苗 | sapling | 5 | dark_oak_sapling |
| 橡树树叶 | leaves | 0 | oak_leaves |
| 云杉树叶 | leaves | 1 | spruce_leaves |
| 白桦树叶 | leaves | 2 | birch_leaves |
| 丛林树叶 | leaves | 3 | jungle_leaves |
| 金合欢树叶 | leaves2 | 0 | acacia_leaves |
| 深色橡树叶 | leaves2 | 1 | dark_oak_leaves |
| 矮草丛 | 0 | tallgrass | short_grass |
| 蕨 | 2 | tallgrass | fern |
| 虞美人 | 0 | red_flower | poppy |
| 兰花 | 1 | red_flower | blue_orchid |
| 绒球葱 | 2 | red_flower | allium |
| 蓝花美耳草 | 3 | red_flower | azure_bluet |
| 红色郁金香 | 4 | red_flower | red_tulip |
| 橙色郁金香 | 5 | red_flower | orange_tulip |
| 白色郁金香 | 6 | red_flower | white_tulip |
| 粉红色郁金香 | 7 | red_flower | pink_tulip |
| 滨菊 | 8 | red_flower | oxeye_daisy |
| 矢车菊 | 9 | red_flower | cornflower |
| 铃兰 | 10 | red_flower | lily_of_the_valley |
| 平滑石台阶 | 0 | stone_block_slab | smooth_stone_slab |
| 砂岩台阶 | 1 | stone_block_slab | sandstone_slab |
| 石化橡木台阶 | 2 | stone_block_slab | petrified_oak_slab |
| 圆石台阶 | 3 | stone_block_slab | cobblestone_slab |
| 红砖台阶 | 4 | stone_block_slab | brick_slab |
| 石砖台阶 | 5 | stone_block_slab | stone_brick_slab |
| 石英台阶 | 6 | stone_block_slab | quartz_slab |
| 下界砖台阶 | 7 | stone_block_slab | nether_brick_slab |
| 双橡木台阶 | 0 | double_wooden_slab | oak_double_slab |
| 双云杉木台阶 | 1 | double_wooden_slab | spruce_double_slab |
| 双白桦木台阶 | 2 | double_wooden_slab | birch_double_slab |
| 双丛林木台阶 | 3 | double_wooden_slab | jungle_double_slab |
| 双金合欢木台阶 | 4 | double_wooden_slab | acacia_double_slab |
| 双深色橡木台阶 | 5 | double_wooden_slab | dark_oak_double_slab |
| 橡木台阶 | 0 | wooden_slab | oak_slab |
| 云杉木台阶 | 1 | wooden_slab | spruce_slab |
| 白桦木台阶 | 2 | wooden_slab | birch_slab |
| 丛林木台阶 | 3 | wooden_slab | jungle_slab |
| 金合欢木台阶 | 4 | wooden_slab | acacia_slab |
| 深色橡木台阶 | 5 | wooden_slab | dark_oak_slab |
| 向日葵 | 0 | double_plant | sunflower |
| 丁香 | 1 | double_plant | lilac |
| 高草丛 | 2 | double_plant | tall_grass |
| 大型蕨 | 3 | double_plant | large_fern |
| 玫瑰丛 | 4 | double_plant | rose_bush |
| 牡丹 | 5 | double_plant | peony |
| 管珊瑚块 | 0 | coral_block | tube_coral_block |
| 脑纹珊瑚块 | 1 | coral_block | brain_coral_block |
| 气泡珊瑚块 | 2 | coral_block | bubble_coral_block |
| 火珊瑚块 | 3 | coral_block | fire_coral_block |
| 鹿角珊瑚块 | 4 | coral_block | horn_coral_block |
| 失活的管珊瑚块 | 5 | coral_block | dead_tube_coral_block |
| 失活的脑纹珊瑚块 | 6 | coral_block | dead_brain_coral_block |
| 失活的气泡珊瑚块 | 7 | coral_block | dead_bubble_coral_block |
| 失活的火珊瑚块 | 8 | coral_block | dead_fire_coral_block |
| 失活的鹿角珊瑚块 | 9 | coral_block | dead_horn_coral_block |
| 管珊瑚扇 | 0 | coral_fan | tube_coral_fan |
| 脑纹珊瑚扇 | 1 | coral_fan | brain_coral_fan |
| 气泡珊瑚扇 | 2 | coral_fan | bubble_coral_fan |
| 火珊瑚扇 | 3 | coral_fan | fire_coral_fan |
| 鹿角珊瑚扇 | 4 | coral_fan | horn_coral_fan |
| 失活的管珊瑚扇 | 0 | coral_fan_dead | dead_tube_coral_fan |
| 失活的脑纹珊瑚扇 | 1 | coral_fan_dead | dead_brain_coral_fan |
| 失活的气泡珊瑚扇 | 2 | coral_fan_dead | dead_bubble_coral_fan |
| 失活的火珊瑚扇 | 3 | coral_fan_dead | dead_fire_coral_fan |
| 失活的鹿角珊瑚扇 | 4 | coral_fan_dead | dead_horn_coral_fan |
| 橡木 | 0 | wood | oak_wood |
| 云杉木 | 1 | wood | spruce_wood |
| 白桦木 | 2 | wood | birch_wood |
| 丛林木 | 3 | wood | jungle_wood |
| 金合欢木 | 4 | wood | acacia_wood |
| 深色橡木 | 5 | wood | dark_oak_wood |
| 去皮橡木 | 8 | wood | stripped_oak_wood |
| 去皮云杉木 | 9 | wood | stripped_spruce_wood |
| 去皮桦木 | 10 | wood | stripped_birch_wood |
| 去皮丛林木 | 11 | wood | stripped_jungle_wood |
| 去皮金合欢木 | 12 | wood | stripped_acacia_wood |
| 去皮深色橡木 | 13 | wood | stripped_dark_oak_wood |