Files
netease-bedrock-wiki/mcguide/20-玩法开发/13-模组SDK编程/2-Python脚本开发/103-3.7版本物品id变更.md
2026-03-09 14:14:44 +08:00

258 lines
15 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 3.7版本物品id变更
## 简介
微软在1.21.50继续修改了部分方块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.7版本变更了id、名称等的物品列表表格内的名称省略了minecraft命名空间。
## 统计信息
- 变更项数量: 89
- 仅名称变更: 12
- 新增项数量: 69
- 移除项数量: 17
### 变更项
| 新中文名 | 旧中文名 | 旧命名 | 旧附加值 | 新命名 | 新附加值 |
| :------ | ------ | ------ | ------ | ------ | ------ |
| 蒲公英 | 蒲公英 | yellow_flower | 0 | dandelion | 0
| 虫蚀石头 | 虫蚀石头 | monster_egg | 0 | infested_stone | 0
| 石砖 | 石砖 | stonebrick | 0 | stone_bricks | 0
| 蘑菇柄 | 蘑菇柄 | brown_mushroom_block | 15 | mushroom_stem | 0
| 双红砂岩台阶 | 红砂岩双层台阶 | double_stone_block_slab2 | 0 | red_sandstone_double_slab | 0
| 红砂岩台阶 | 红砂岩台阶 | stone_block_slab2 | 0 | red_sandstone_slab | 0
| 末地石砖台阶 | 末地石砖台阶 | stone_block_slab3 | 0 | end_stone_brick_slab | 0
| 苔石砖台阶 | 苔石砖台阶 | stone_block_slab4 | 0 | mossy_stone_brick_slab | 0
| 光源方块-亮度0 | 光源方块 | light_block | 0 | light_block_0 | 0
| 虫蚀圆石 | 虫蚀圆石 | monster_egg | 1 | infested_cobblestone | 0
| 虫蚀石砖 | 虫蚀石砖 | monster_egg | 2 | infested_stone_bricks | 0
| 虫蚀苔石砖 | 虫蚀苔石砖 | monster_egg | 3 | infested_mossy_stone_bricks | 0
| 虫蚀裂纹石砖 | 虫蚀裂纹石砖 | monster_egg | 4 | infested_cracked_stone_bricks | 0
| 虫蚀雕纹石砖 | 虫蚀雕纹石砖 | monster_egg | 5 | infested_chiseled_stone_bricks | 0
| 苔石砖 | 苔石砖 | stonebrick | 1 | mossy_stone_bricks | 0
| 裂纹石砖 | 裂纹石砖 | stonebrick | 2 | cracked_stone_bricks | 0
| 雕纹石砖 | 雕纹石砖 | stonebrick | 3 | chiseled_stone_bricks | 0
| 双砂岩台阶 | 砂岩双层台阶 | double_stone_block_slab | 1 | sandstone_double_slab | 0
| 双圆石台阶 | 圆石双层台阶 | double_stone_block_slab | 3 | cobblestone_double_slab | 0
| 双红砖台阶 | 红砖双层台阶 | double_stone_block_slab | 4 | brick_double_slab | 0
| 双石砖台阶 | 石砖双层台阶 | double_stone_block_slab | 5 | stone_brick_double_slab | 0
| 双石英台阶 | 石英双层台阶 | double_stone_block_slab | 6 | quartz_double_slab | 0
| 双下界砖台阶 | 下界砖双层台阶 | double_stone_block_slab | 7 | nether_brick_double_slab | 0
| 紫珀台阶 | 紫珀台阶 | stone_block_slab2 | 1 | purpur_slab | 0
| 海晶石台阶 | 海晶石台阶 | stone_block_slab2 | 2 | prismarine_slab | 0
| 暗海晶石台阶 | 暗海晶石台阶 | stone_block_slab2 | 3 | dark_prismarine_slab | 0
| 海晶石砖台阶 | 海晶石砖台阶 | stone_block_slab2 | 4 | prismarine_brick_slab | 0
| 苔石台阶 | 苔石台阶 | stone_block_slab2 | 5 | mossy_cobblestone_slab | 0
| 平滑砂岩台阶 | 平滑砂岩台阶 | stone_block_slab2 | 6 | smooth_sandstone_slab | 0
| 红色下界砖台阶 | 红色下界砖台阶 | stone_block_slab2 | 7 | red_nether_brick_slab | 0
| 平滑红砂岩台阶 | 平滑红砂岩台阶 | stone_block_slab3 | 1 | smooth_red_sandstone_slab | 0
| 磨制安山岩台阶 | 磨制安山岩台阶 | stone_block_slab3 | 2 | polished_andesite_slab | 0
| 安山岩台阶 | 安山岩台阶 | stone_block_slab3 | 3 | andesite_slab | 0
| 闪长岩台阶 | 闪长岩台阶 | stone_block_slab3 | 4 | diorite_slab | 0
| 磨制闪长岩台阶 | 磨制闪长岩台阶 | stone_block_slab3 | 5 | polished_diorite_slab | 0
| 花岗岩台阶 | 花岗岩台阶 | stone_block_slab3 | 6 | granite_slab | 0
| 磨制花岗岩台阶 | 磨制花岗岩台阶 | stone_block_slab3 | 7 | polished_granite_slab | 0
| 平滑石英台阶 | 平滑石英台阶 | stone_block_slab4 | 1 | smooth_quartz_slab | 0
| 石头台阶 | 石头台阶 | stone_block_slab4 | 2 | normal_stone_slab | 0
| 切制砂岩台阶 | 切制砂岩台阶 | stone_block_slab4 | 3 | cut_sandstone_slab | 0
| 切制红砂岩台阶 | 切制红砂岩台阶 | stone_block_slab4 | 4 | cut_red_sandstone_slab | 0
| 双石化橡木台阶 | 石化橡木双层台阶 | double_stone_block_slab | 2 | petrified_oak_double_slab | 0
| 双紫珀台阶 | 双紫珀台阶 | double_stone_block_slab2 | 1 | purpur_double_slab | 0
| 双海晶石台阶 | 双海晶石台阶 | double_stone_block_slab2 | 2 | prismarine_double_slab | 0
| 双暗海晶石台阶 | 双暗海晶石台阶 | double_stone_block_slab2 | 3 | dark_prismarine_double_slab | 0
| 双海晶石砖台阶 | 双海晶石砖台阶 | double_stone_block_slab2 | 4 | prismarine_brick_double_slab | 0
| 双苔石台阶 | 双苔石台阶 | double_stone_block_slab2 | 5 | mossy_cobblestone_double_slab | 0
| 双平滑砂岩台阶 | 双平滑砂岩台阶 | double_stone_block_slab2 | 6 | smooth_sandstone_double_slab | 0
| 双红色下界砖台阶 | 双红色下界砖台阶 | double_stone_block_slab2 | 7 | red_nether_brick_double_slab | 0
| 双平滑红砂岩台阶 | 双平滑红砂岩台阶 | double_stone_block_slab3 | 1 | smooth_red_sandstone_double_slab | 0
| 双磨制安山岩台阶 | 双磨制安山岩台阶 | double_stone_block_slab3 | 2 | polished_andesite_double_slab | 0
| 双安山岩台阶 | 双安山岩台阶 | double_stone_block_slab3 | 3 | andesite_double_slab | 0
| 双闪长岩台阶 | 双闪长岩台阶 | double_stone_block_slab3 | 4 | diorite_double_slab | 0
| 双磨制闪长岩台阶 | 双磨制闪长岩台阶 | double_stone_block_slab3 | 5 | polished_diorite_double_slab | 0
| 双花岗岩台阶 | 双花岗岩台阶 | double_stone_block_slab3 | 6 | granite_double_slab | 0
| 双磨制花岗岩台阶 | 双磨制花岗岩台阶 | double_stone_block_slab3 | 7 | polished_granite_double_slab | 0
| 双平滑石英台阶 | 双平滑石英台阶 | double_stone_block_slab4 | 1 | smooth_quartz_double_slab | 0
| 双石台阶 | 双石台阶 | double_stone_block_slab4 | 2 | normal_stone_double_slab | 0
| 双切制砂岩台阶 | 双切制砂岩台阶 | double_stone_block_slab4 | 3 | cut_sandstone_double_slab | 0
| 双切制红砂岩台阶 | 双切制红砂岩台阶 | double_stone_block_slab4 | 4 | cut_red_sandstone_double_slab | 0
| 雕纹砂岩 | 雕纹砂岩 | sandstone | 1 | chiseled_sandstone | 0
| 切制砂岩 | 切制砂岩 | sandstone | 2 | cut_sandstone | 0
| 平滑砂岩 | 平滑砂岩 | sandstone | 3 | smooth_sandstone | 0
| 暗海晶石 | 暗海晶石 | prismarine | 1 | dark_prismarine | 0
| 海晶石砖 | 海晶石砖 | prismarine | 2 | prismarine_bricks | 0
| 红沙 | 红沙 | sand | 1 | red_sand | 0
| 雕纹石英块 | 雕纹石英块 | quartz_block | 1 | chiseled_quartz_block | 0
| 石英柱 | 石英柱 | quartz_block | 2 | quartz_pillar | 0
| 平滑石英块 | 平滑石英块 | quartz_block | 3 | smooth_quartz | 0
| 雕纹红砂岩 | 雕纹红砂岩 | red_sandstone | 1 | chiseled_red_sandstone | 0
| 切制红砂岩 | 切制红砂岩 | red_sandstone | 2 | cut_red_sandstone | 0
| 平滑红砂岩 | 平滑红砂岩 | red_sandstone | 3 | smooth_red_sandstone | 0
| 开裂的铁砧 | 开裂的铁砧 | anvil | 4 | chipped_anvil | 0
| 损坏的铁砧 | 损坏的铁砧 | anvil | 8 | damaged_anvil | 0
| 砂土 | 砂土 | dirt | 1 | coarse_dirt | 0
| 苔石墙 | 苔石墙 | cobblestone_wall | 1 | mossy_cobblestone_wall | 0
| 花岗岩墙 | 花岗岩墙 | cobblestone_wall | 2 | granite_wall | 0
| 闪长岩墙 | 闪长岩墙 | cobblestone_wall | 3 | diorite_wall | 0
| 安山岩墙 | 安山岩墙 | cobblestone_wall | 4 | andesite_wall | 0
| 砂岩墙 | 砂岩墙 | cobblestone_wall | 5 | sandstone_wall | 0
| 红砖墙 | 红砖墙 | cobblestone_wall | 6 | brick_wall | 0
| 石砖墙 | 石砖墙 | cobblestone_wall | 7 | stone_brick_wall | 0
| 苔石砖墙 | 苔石砖墙 | cobblestone_wall | 8 | mossy_stone_brick_wall | 0
| 下界砖墙 | 下界砖墙 | cobblestone_wall | 9 | nether_brick_wall | 0
| 末地石砖墙 | 末地石砖墙 | cobblestone_wall | 10 | end_stone_brick_wall | 0
| 海晶石墙 | 海晶石墙 | cobblestone_wall | 11 | prismarine_wall | 0
| 红砂岩墙 | 红砂岩墙 | cobblestone_wall | 12 | red_sandstone_wall | 0
| 红色下界砖墙 | 红色下界砖墙 | cobblestone_wall | 13 | red_nether_brick_wall | 0
| 湿海绵 | 湿海绵 | sponge | 1 | wet_sponge | 0
### 仅名称变更(内容不变)
| 新中文名 | 旧中文名 | 英文命名 | 附加值 |
| :------ | ------ | ------ | ------ |
| 橡木门 | 木门 | wooden_door | 0 |
| 双绯红木台阶 | 绯红木双层台阶 | crimson_double_slab | 0 |
| 双诡异木台阶 | 诡异木双层台阶 | warped_double_slab | 0 |
| 双深板岩圆石台阶 | 深板岩圆石双层台阶 | cobbled_deepslate_double_slab | 0 |
| 双磨制深板岩台阶 | 磨制深板岩双层台阶 | polished_deepslate_double_slab | 0 |
| 双深板岩瓦台阶 | 深板岩瓦双层台阶 | deepslate_tile_double_slab | 0 |
| 双深板岩砖台阶 | 深板岩砖双层台阶 | deepslate_brick_double_slab | 0 |
| 悬挂式云杉木告示牌 | 云杉木悬挂告示牌 | spruce_hanging_sign | 0 |
| 悬挂式白桦木告示牌 | 白桦木悬挂告示牌 | birch_hanging_sign | 0 |
| 悬挂式金合欢木告示牌 | 金合欢木悬挂告示牌 | acacia_hanging_sign | 0 |
| 悬挂式深色橡木告示牌 | 深色橡木悬挂告示牌 | dark_oak_hanging_sign | 0 |
| 双樱花木台阶 | 樱花木双层台阶 | cherry_double_slab | 0 |
### 新增项
| 中文名称 | 英文命名 | 附加值 |
| :------ | ------ | ------ |
| 双平滑石头台阶 | smooth_stone_double_slab | 0 |
| 下界砖 | nether_brick | 0 |
| 骷髅模型 | skeleton_skull | 0 |
| 潜声感测器 | sculk_sensor | 0 |
| 荧光物品展示框 | glow_frame | 0 |
| 潜声 | sculk | 0 |
| 红树木门 | mangrove_door | 0 |
| 红树木告示牌 | mangrove_standing_sign | 0 |
| 双红树木台阶 | mangrove_double_slab | 0 |
| 悬挂式橡木告示牌 | oak_hanging_sign | 0 |
| 悬挂式丛林木告示牌 | jungle_hanging_sign | 0 |
| 悬挂式绯红木告示牌 | crimson_hanging_sign | 0 |
| 悬挂式诡异木告示牌 | warped_hanging_sign | 0 |
| 悬挂式红树木告示牌 | mangrove_hanging_sign | 0 |
| 悬挂式竹告示牌 | bamboo_hanging_sign | 0 |
| 悬挂式樱花木告示牌 | cherry_hanging_sign | 0 |
| 光源方块-亮度1 | light_block_1 | 0 |
| 光源方块-亮度2 | light_block_2 | 0 |
| 光源方块-亮度3 | light_block_3 | 0 |
| 光源方块-亮度4 | light_block_4 | 0 |
| 光源方块-亮度5 | light_block_5 | 0 |
| 光源方块-亮度6 | light_block_6 | 0 |
| 光源方块-亮度7 | light_block_7 | 0 |
| 光源方块-亮度8 | light_block_8 | 0 |
| 光源方块-亮度9 | light_block_9 | 0 |
| 光源方块-亮度10 | light_block_10 | 0 |
| 光源方块-亮度11 | light_block_11 | 0 |
| 光源方块-亮度12 | light_block_12 | 0 |
| 光源方块-亮度13 | light_block_13 | 0 |
| 光源方块-亮度14 | light_block_14 | 0 |
| 光源方块-亮度15 | light_block_15 | 0 |
| 紫珀柱 | purpur_pillar | 0 |
| 凋灵骷髅模型 | wither_skeleton_skull | 0 |
| 僵尸模型 | zombie_head | 0 |
| 模型 | player_head | 0 |
| 苦力怕模型 | creeper_head | 0 |
| 龙的模型 | dragon_head | 0 |
| 猪灵模型 | piglin_head | 0 |
| 苍白橡木按钮 | pale_oak_button | 0 |
| 苍白橡木门 | pale_oak_door | 0 |
| 苍白橡木栅栏 | pale_oak_fence | 0 |
| 苍白橡木栅栏大门 | pale_oak_fence_gate | 0 |
| 苍白橡木悬挂告示牌 | pale_oak_hanging_sign | 0 |
| 去皮苍白橡树原木 | stripped_pale_oak_log | 0 |
| 苍白橡树原木 | pale_oak_log | 0 |
| 苍白橡木木板 | pale_oak_planks | 0 |
| 苍白橡木压力板 | pale_oak_pressure_plate | 0 |
| 苍白橡木台阶 | pale_oak_slab | 0 |
| 苍白橡木双台阶 | pale_oak_double_slab | 0 |
| 苍白橡木楼梯 | pale_oak_stairs | 0 |
| 苍白橡木活板门 | pale_oak_trapdoor | 0 |
| 去皮苍白橡木 | stripped_pale_oak_wood | 0 |
| 苍白橡木 | pale_oak_wood | 0 |
| 苍白橡木树苗 | pale_oak_sapling | 0 |
| 苍白橡木树叶 | pale_oak_leaves | 0 |
| 苍白苔藓块 | pale_moss_block | 0 |
| 苍白苔藓地毯 | pale_moss_carpet | 0 |
| 苍白垂须 | pale_hanging_moss | 0 |
| 嘎枝之心 | creaking_heart | 0 |
| 树脂砖块 | resin_bricks | 0 |
| 树脂砖台阶 | resin_brick_slab | 0 |
| 双树脂砖台阶 | resin_brick_double_slab | 0 |
| 树脂砖楼梯 | resin_brick_stairs | 0 |
| 树脂砖墙 | resin_brick_wall | 0 |
| 张开的眼眸花 | open_eyeblossom | 0 |
| 闭合的眼眸花 | closed_eyeblossom | 0 |
| 雕纹树脂砖块 | chiseled_resin_bricks | 0 |
| 树脂块 | resin_block | 0 |
| 树脂团 | resin_clump | 0 |
### 移除项
| 中文名称 | 英文命名 | 附加值 |
| :------ | ------ | ------ |
| 石头双层台阶 | double_stone_block_slab | 0 |
| 蘑菇 | brown_mushroom_block | 0 |
| 下界砖块 | nether_brick | 0 |
| 生物头颅 | skull | 0 |
| 紫珀柱子 | purpur_block | 2 |
| 幽匿感测体 | sculk_sensor | 0 |
| 幽匿块 | sculk | 0 |
| 红树林门 | mangrove_door | 0 |
| 红树林告示牌 | mangrove_standing_sign | 0 |
| 双红树林台阶 | mangrove_double_slab | 0 |
| 橡树悬挂告示牌 | oak_hanging_sign | 0 |
| 丛林悬挂告示牌 | jungle_hanging_sign | 0 |
| 绯红悬挂告示牌 | crimson_hanging_sign | 0 |
| 翘曲悬挂告示牌 | warped_hanging_sign | 0 |
| 红树林悬挂告示牌 | mangrove_hanging_sign | 0 |
| 竹制悬挂告示牌 | bamboo_hanging_sign | 0 |
| 樱花悬挂告示牌 | cherry_hanging_sign | 0 |