xiaokun/netease-modsdk-wiki
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
1d963e83079d80a7833fdb2ed511009c93316eaa
netease-modsdk-wiki/docs/mcguide/20-玩法开发/13-模组SDK编程/2-Python脚本开发/103-3.7版本物品id变更.md
小坤 1d963e8307
Some checks failed
Deploy VitePress to AliYun OSS / build-and-deploy (push) Has been cancelled
Details
补充3.7版本文档：物理系统API/事件/枚举值、游戏设置事件、物品ID变更、物理使用指南
2026-03-02 00:17:03 +08:00

15 KiB
Raw Blame History

3.7版本物品id变更

简介

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

处理方法

在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.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