--- front: https://nie.res.netease.com/r/pic/20210727/82dd4b1e-04e1-4a90-a4c5-1a4d5cec462a.png hard: 入门 time: 10分钟 --- # 1.23版本物品id变更 ## 简介 1.23版本与1.22版本相比，有部分物品的名称发生了变更，例如生鱼从minecraft:fish变为minecraft:cod；牛奶桶从minecraft:bucket，附加值为1，改为minecraft:milk_bucket，附加值为0。 ## 处理方法 在ModSDK的接口与事件中，我们针对上述情况做了以下处理： 1. 对于接受物品名称与附加值的接口，同时兼容旧版名称与新版名称 如SetUiItem接口 2. 在物品信息字典中添加newItemName及newAuxValue字段。 * 对于返回物品信息字典的接口与事件： 新字段newItemName及newAuxValue返回新版名称与附加值。 原字段itemName及auxValue返回旧版名称与附加值。 例如GetPlayerItem接口，OnCarriedNewItemChangedServerEvent事件 * 对于接受物品信息字典的接口与事件： 当字典存在newItemName及newAuxValue时，使用这两个新字段。 不存在时，使用旧字段itemName及auxValue。 例如SpawnItemToPlayerCarried接口，EntityDieLoottableServerEvent事件 ## 注意事项 * 获取配方的接口，返回值没有做兼容，例如GetRecipeResult，GetRecipesByResult，GetRecipesByInput，将返回新版名称与附加值，如果您的组件对此有依赖，则需要对这次的改动自行做兼容处理。 * 新开发或正在开发的组件，建议统一采用新的newItemName及newAuxValue字段，也不要新旧字段混用。 * 某些写法可能会失效，例如 ```python # 获取itemDict，然后在他基础上修改itemName或auxValue后再用来生成 itemdict = GetPlayerItem() itemdict['itemName'] = 'xxx' itemdict['auxValue'] = itemdict['auxValue']+1 SpawnItemToPlayerInv(itemdict) ``` 因为GetPlayerItem返回的itemDict含有新字段，再传入SpawnItemToPlayerInv时，会读取新字段生成物品，因此对原字段的修改无效。 ## 物品名称变更表 以下为1.23版本变更了名称的物品列表。表格内的名称省略了minecraft命名空间。 | 旧名称 | 旧附加值 | 新名称 | | ------------------- | ---------- | ------------------------------- | | carrotonastick | | carrot_on_a_stick | | fish | | cod | | cooked_fish | | cooked_cod | | clownfish | | tropical_fish | | muttoncooked | | cooked_mutton | | appleenchanted | | enchanted_golden_apple | | fireball | | fire_charge | | fireworks | | firework_rocket | | fireworkscharge | | firework_star | | speckled_melon | | glistering_melon_slice | | record_11 | | music_disc_11 | | record_13 | | music_disc_13 | | record_blocks | | music_disc_blocks | | record_cat | | music_disc_cat | | record_chirp | | music_disc_chirp | | record_far | | music_disc_far | | record_mall | | music_disc_mall | | record_mellohi | | music_disc_mellohi | | record_pigstep | | music_disc_pigstep | | record_stal | | music_disc_stal | | record_strad | | music_disc_strad | | record_wait | | music_disc_wait | | record_ward | | music_disc_ward | | muttonraw | | mutton | | netherstar | | nether_star | | chorus_fruit_popped | | popped_chorus_fruit | | melon | | melon_slice | | reeds | | sugar_cane | | horsearmorleather | | leather_horse_armor | | horsearmoriron | | iron_horse_armor | | horsearmorgold | | golden_horse_armor | | horsearmordiamond | | diamond_horse_armor | | turtle_shell_piece | | scute | | totem | | totem_of_undying | | lodestonecompass | | lodestone_compass | | map | | filled_map | | emptymap | | empty_map | | sign | | oak_sign | | darkoak_sign | | dark_oak_sign | | boat | 0 | oak_boat | | boat | 1 | spruce_boat | | boat | 2 | birch_boat | | boat | 3 | jungle_boat | | boat | 4 | acacia_boat | | boat | 5 | dark_oak_boat | | coal | 0 | coal | | coal | 1 | charcoal | | bucket | 0 | bucket | | bucket | 1 | milk_bucket | | bucket | 2 | cod_bucket | | bucket | 3 | salmon_bucket | | bucket | 4 | tropical_fish_bucket | | bucket | 5 | pufferfish_bucket | | bucket | 8 | water_bucket | | bucket | 10 | lava_bucket | | dye | 0 | ink_sac | | dye | 1 | red_dye | | dye | 2 | green_dye | | dye | 3 | cocoa_beans | | dye | 4 | lapis_lazuli | | dye | 5 | purple_dye | | dye | 6 | cyan_dye | | dye | 7 | light_gray_dye | | dye | 8 | gray_dye | | dye | 9 | pink_dye | | dye | 10 | lime_dye | | dye | 11 | yellow_dye | | dye | 12 | light_blue_dye | | dye | 13 | magenta_dye | | dye | 14 | orange_dye | | dye | 15 | bone_meal | | dye | 16 | black_dye | | dye | 17 | brown_dye | | dye | 18 | blue_dye | | dye | 19 | white_dye | | banner_pattern | 0 | creeper_banner_pattern | | banner_pattern | 1 | skull_banner_pattern | | banner_pattern | 2 | flower_banner_pattern | | banner_pattern | 3 | mojang_banner_pattern | | banner_pattern | 4 | field_masoned_banner_pattern | | banner_pattern | 5 | bordure_indented_banner_pattern | | banner_pattern | 6 | piglin_banner_pattern | | spawn_egg | 10 | chicken_spawn_egg | | spawn_egg | 11 | cow_spawn_egg | | spawn_egg | 12 | pig_spawn_egg | | spawn_egg | 13 | sheep_spawn_egg | | spawn_egg | 14 | wolf_spawn_egg | | spawn_egg | 15 | villager_spawn_egg | | spawn_egg | 16 | mooshroom_spawn_egg | | spawn_egg | 17 | squid_spawn_egg | | spawn_egg | 18 | rabbit_spawn_egg | | spawn_egg | 19 | bat_spawn_egg | | spawn_egg | 22 | ocelot_spawn_egg | | spawn_egg | 23 | horse_spawn_egg | | spawn_egg | 24 | donkey_spawn_egg | | spawn_egg | 25 | mule_spawn_egg | | spawn_egg | 26 | skeleton_horse_spawn_egg | | spawn_egg | 27 | zombie_horse_spawn_egg | | spawn_egg | 28 | polar_bear_spawn_egg | | spawn_egg | 29 | llama_spawn_egg | | spawn_egg | 30 | parrot_spawn_egg | | spawn_egg | 31 | dolphin_spawn_egg | | spawn_egg | 32 | zombie_spawn_egg | | spawn_egg | 33 | creeper_spawn_egg | | spawn_egg | 34 | skeleton_spawn_egg | | spawn_egg | 35 | spider_spawn_egg | | spawn_egg | 36 | zombie_pigman_spawn_egg | | spawn_egg | 37 | slime_spawn_egg | | spawn_egg | 38 | enderman_spawn_egg | | spawn_egg | 39 | silverfish_spawn_egg | | spawn_egg | 40 | cave_spider_spawn_egg | | spawn_egg | 41 | ghast_spawn_egg | | spawn_egg | 42 | magma_cube_spawn_egg | | spawn_egg | 43 | blaze_spawn_egg | | spawn_egg | 44 | zombie_villager_spawn_egg | | spawn_egg | 45 | witch_spawn_egg | | spawn_egg | 46 | stray_spawn_egg | | spawn_egg | 47 | husk_spawn_egg | | spawn_egg | 48 | wither_skeleton_spawn_egg | | spawn_egg | 49 | guardian_spawn_egg | | spawn_egg | 50 | elder_guardian_spawn_egg | | spawn_egg | 51 | npc_spawn_egg | | spawn_egg | 54 | shulker_spawn_egg | | spawn_egg | 55 | endermite_spawn_egg | | spawn_egg | 56 | agent_spawn_egg | | spawn_egg | 57 | vindicator_spawn_egg | | spawn_egg | 58 | phantom_spawn_egg | | spawn_egg | 59 | ravager_spawn_egg | | spawn_egg | 74 | turtle_spawn_egg | | spawn_egg | 75 | cat_spawn_egg | | spawn_egg | 104 | evoker_spawn_egg | | spawn_egg | 105 | vex_spawn_egg | | spawn_egg | 108 | pufferfish_spawn_egg | | spawn_egg | 109 | salmon_spawn_egg | | spawn_egg | 110 | drowned_spawn_egg | | spawn_egg | 111 | tropical_fish_spawn_egg | | spawn_egg | 112 | cod_spawn_egg | | spawn_egg | 113 | panda_spawn_egg | | spawn_egg | 114 | pillager_spawn_egg | | spawn_egg | 115 | villager_spawn_egg | | spawn_egg | 116 | zombie_villager_spawn_egg | | spawn_egg | 118 | wandering_trader_spawn_egg | | spawn_egg | 121 | fox_spawn_egg | | spawn_egg | 122 | bee_spawn_egg | | spawn_egg | 123 | piglin_spawn_egg | | spawn_egg | 124 | hoglin_spawn_egg | | spawn_egg | 125 | strider_spawn_egg | | spawn_egg | 126 | zoglin_spawn_egg | | spawn_egg | 127 | piglin_brute_spawn_egg | | spawn_egg | 128 | goat_spawn_egg | | spawn_egg | 自定义生物 | 生物identifier_spawn_egg |