# 3.4版本物品id变更

# 简介

微软在1.21.00继续修改了部分方块ID,取消了附加值,相关链接请参阅基岩版扁平化 (opens new window),请开发者注意适配。

# 处理方法

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

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

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

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

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

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

# 物品名称变更表

以下为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

简介

处理方法

注意事项

物品名称变更表