netease-modsdk-wiki/docs/mcdocs/1-ModAPI/更新信息/2.12.md

2.12

2024.05.23：版本号（V2.12 BE1.20.10） 包括Mod PC包，手机测试版启动器，和服务器引擎。

示例Demo：前往此处下载

一、更新时间表

1. 在2024年5月23日上线2.12第一个Beta版。
2. 在2024年6月6日上线2.12第二个Beta版。
3. 在2024年6月20日上线2.12稳定版。
4. 在2024年6月28日，全渠道将更新2.12版本玩家包体，玩家将陆续更新到2.12版本，请开发者合理安排更新节奏。

二、重要功能更新

1. 由于部分物品的名称与附加值存在变更，物品信息字典对ItemName及AuxValue字段以兼容，详见 2.12版本物品id变更 。
2. /clone、/execute、/fill、/setblock、/testforblock指令写法变更，移除了数据参数，例如/setblock ~ ~ ~ minecraft:wool 1现在需要改写为/setblock ~ ~ ~ minecraft:wool ["color":"orange"]。2.12版本对旧版指令写法兼容，推荐使用新版写法。
3. 2.12版本带来众多枚举值更新

三、API更新

• 新增

1. 新增EnableFontBatchRender(客户端)， 是否开启字体合批

• 调整

1. 调整SetSignTextStyle(服务端)， 支持告示牌文本样式的双面设置

2. 调整GetSignTextStyle(服务端)， 支持告示牌文本样式的双面设置

3. 调整GetSignBlockText(服务端)， 支持告示牌文本的双面设置

4. 调整SetSignBlockText(服务端)， 支持告示牌文本的双面设置

5. 调整OnContainerFillLoottableServerEvent(服务端)， 适配使用刷子刷可疑的沙子

6. 调整GetBlockStates(服务端)， 基岩版1.19更新后，部分包含多个种类的方块（例如，羊毛类，珊瑚类，栅栏类等类型的方块）被拆分成单独的方块，拥有新的identifier及方块附加值，因此原来的方块附加值及部分方块状态不再适用，也请注意尽量使用新的方块identifier。

7. 调整SetBlockStates(服务端)， 基岩版1.19更新后，部分包含多个种类的方块（例如，羊毛类，珊瑚类，栅栏类等类型的方块）被拆分成单独的方块，拥有新的identifier及方块附加值，因此原来的方块附加值及部分方块状态不再适用，也请注意尽量使用新的方块identifier。

8. 调整GetBlockAuxValueFromStates(服务端)， 基岩版1.19更新后，部分包含多个种类的方块（例如，羊毛类，珊瑚类，栅栏类等类型的方块）被拆分成单独的方块，拥有新的identifier及方块附加值，因此原来的方块附加值及部分方块状态不再适用，也请注意尽量使用新的方块identifier。

9. 调整GetBlockStatesFromAuxValue(服务端)， 基岩版1.19更新后，部分包含多个种类的方块（例如，羊毛类，珊瑚类，栅栏类等类型的方块）被拆分成单独的方块，拥有新的identifier及方块附加值，因此原来的方块附加值及部分方块状态不再适用，也请注意尽量使用新的方块identifier。

10. 调整AddRecipe(服务端)， 基岩版1.20更新后，酿造台的药水槽每次只能放进一个物品，无法一次放入两个及以上数量的物品。

11. 调整GetRecipeResult(服务端)， 返回的配方列表中的输入物品里，’item'字段对应的值有可能为列表类型(list)，也可能为字符串类型(str)

12. 调整GetRecipesByResult(服务端)， 返回的配方列表中的输入物品里，’item'字段对应的值有可能为列表类型(list)，也可能为字符串类型(str)

13. 调整GetRecipesByInput(服务端)， 返回的配方列表中的输入物品里，’item'字段对应的值有可能为列表类型(list)，也可能为字符串类型(str)

14. 调整GetRecipesByResult(客户端)， 返回的配方列表中的输入物品里，’item'字段对应的值有可能为列表类型(list)，也可能为字符串类型(str)

15. 调整GetRecipesByInput(客户端)， 返回的配方列表中的输入物品里，’item'字段对应的值有可能为列表类型(list)，也可能为字符串类型(str)

16. 调整ActorDamageCause枚举，新增SonicBoom(音波尖啸)、Campfire(营火) 、SoulCampfire(灵魂营火)。

17. 调整ItemUseMethodEnum枚举，新增BrushingCompleted(刷子清刷完毕)。

18. 调整StructureFeatureType枚举，新增AncientCity(远古城市)、TrailRuins(古迹废墟)、NeteaseLargeFeature(网易版大型结构特征)。

19. 调整EntityType枚举，新增Warden(坚守者)、Frog(青蛙)、Tadpole(蝌蚪)、Allay(悦灵)、ChestBoatRideable(可乘骑运输船)、TraderLlama(行商羊驼)、Camel(骆驼)、Sniffer(嗅探兽)。

20. 调整EnchantType枚举，新增SwiftSneak(迅捷潜行)，调整NumEnchantments(附魔种数)和InvalidEnchantment(无效附魔)的顺序。

21. 调整BiomeType枚举，新增deep_dark(深暗之域)、mangrove_swamp(红树林沼泽)、cherry_grove(樱花树林)。

22. 调整EffectType枚举，新增DARKNESS(黑暗状态效果)。

23. 调整UseAnimation枚举，新增Brush(刷)。

24. 调整EnchantSlotType枚举，新增BRUSH(刷子)。

25. 调整OpenContainerId枚举，新增SmithingTableTemplateContainer(锻造台模板位)、GrindstoneResultPreviewContainer(砂轮预览位)、RecipeBookContainer(配方位)。

26. 调整ContainerType枚举，新增CHEST_BOAT(运输船)。

27. 调整PlayerUISlot枚举，新增SmithingTableTemplate(锻造台模板位)。

28. 调整AttributeBuffType枚举，新增SelfDestruct(自毁)。

29. 调整GameType枚举，新增Spectator(旁观模式)。

• 修复

1. 修复GetChinese(服务端)， 返回值添加字符编码描述

2. 修复GetRiders(服务端)， 修复返回值描述为list(dict)

3. 修复GetChinese(客户端)， 返回值添加字符编码描述

4. 修复ClientChestOpenEvent(客户端)， 末影龙箱子修改为末影箱,补充实体容器相关描述

5. 修复ClientChestCloseEvent(客户端)， 末影龙箱子修改为末影箱,补充实体容器相关描述