xiaokun/netease-bedrock-wiki
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat:上传mcguide-开发指南部份

Browse Source
This commit is contained in:
Othniel su
2024-12-23 10:57:59 +08:00
parent 7292166c88
commit 0dc59fa4f0
3297 changed files with 63375 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

219
mcguide/20-玩法开发/13-模组SDK编程/2-Python脚本开发/99-1.23版本物品id变更.md Normal file
View File

@@ -0,0 +1,219 @@
---
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 |