diff --git a/mcguide/16-美术/6-模型和动作/6-模型规范指南.md b/mcguide/16-美术/6-模型和动作/6-模型规范指南.md index 2bb2e6f..3d8e930 100644 --- a/mcguide/16-美术/6-模型和动作/6-模型规范指南.md +++ b/mcguide/16-美术/6-模型和动作/6-模型规范指南.md @@ -157,7 +157,11 @@ def onUpdatePlayerSkinClient(self,args): 为方便开发者测试4D皮肤与模组本身的兼容性，官方在**开发者测试服（手机自测）**提供了测试用4D皮肤，可通过邮件领取 -**注意：** 请各位开发者更新到3.5测试服，3.4该测试皮肤不会生效 +**注意：** + +- 请各位开发者更新到3.5测试服，3.4该测试皮肤不会生效 + +- 自3.7版本之后，渲染龙包体无法使用4D皮肤。开发者请勿在游戏内视频设置中切换为渲染龙，这将导致断言报错 #### MC Studio diff --git a/mcguide/20-玩法开发/13-模组SDK编程/2-Python脚本开发/103-3.7版本物品id变更.md b/mcguide/20-玩法开发/13-模组SDK编程/2-Python脚本开发/103-3.7版本物品id变更.md new file mode 100644 index 0000000..ae55188 --- /dev/null +++ b/mcguide/20-玩法开发/13-模组SDK编程/2-Python脚本开发/103-3.7版本物品id变更.md @@ -0,0 +1,257 @@ +# 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 | diff --git a/mcguide/30-测试/images/tracy09.png b/mcguide/30-测试/images/tracy09.png index 8e233dd..a89f55f 100644 Binary files a/mcguide/30-测试/images/tracy09.png and b/mcguide/30-测试/images/tracy09.png differ diff --git a/mconline/10-addon教程/第12章：更完善的自定义掉落物/课程05.简易教学①自定义掉落一种颜色的羊毛.md b/mconline/10-addon教程/第12章：更完善的自定义掉落物/课程05.简易教学①自定义掉落一种颜色的羊毛.md index 8d9c21c..af4eea7 100644 --- a/mconline/10-addon教程/第12章：更完善的自定义掉落物/课程05.简易教学①自定义掉落一种颜色的羊毛.md +++ b/mconline/10-addon教程/第12章：更完善的自定义掉落物/课程05.简易教学①自定义掉落一种颜色的羊毛.md @@ -45,7 +45,7 @@ time: 10分钟 { "rolls": 1, "entries": [ - {“type”: "item", "name": "minecraft:wool","function": [{"function": "set_data","data":15}]} + {"type": "item", "name": "minecraft:wool", "function": [{"function": "set_data", "data":15}]} ] } ]