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

1.25

温馨提示，预计在11月26日，全渠道更新1.25版本玩家包体，玩家将陆续更新到1.25版本，请开发者合理安排更新节奏。

2021.11.18：版本号（v1.25 BE1.16.203）

• 新增重大功能介绍

1.自定义生物AI

• 可在脚本层扩展生物AI，实现更多的生物表现。

  详见 自定义生物行为 ，举例详见离线包中的CustomEntityMod。

2.虚拟世界支持微软原版模型

• 可更便捷实现回合制或小场景玩法。

  详见ModelCreateMinecraftObject以及ModelUpdateAnimationMolangVariable，举例详见离线包中的VirtualWorldDemo。

3.结构体功能拓展

• 结构体支持旋转，可旋转90，180，270度

• 支持使用PlaceStructure或通过结构特征json旋转

  详见PlaceStructure 或 结构特征json旋转方式

4.自定义维度拓展

• 自定义维度新增netease:ban_vanilla_feature,可让该维度禁止生成原版feature,可用于解决类似空岛生存天空悬浮结构问题

  详见 自定义维度

5.支持按维度独立设置天气，详见天气

6.新增后处理功能，可实现高斯模糊、颜色矫正、景深、镜头污迹等效果，详见后处理

• 新增

1. 自定义方块实体外观 支持多面向

2. 自定义方块增加 netease:on_entity_inside 、netease:on_step_on、netease:on_step_off组件

3. 自定义物品增加 netease:enchant_material组件

4. UI新增 单选下拉框控件

5. 新增GetCustomGoalCls(服务端)， 增加获取自定义行为节点基类的接口

6. 新增SetEnableReconnectNetgame(客户端)， 设置是否允许断线重连

7. 新增SetResourceFastload(客户端)， 设置资源快速加载

8. 新增GetResourceFastload(客户端)， 获取资源快速加载设置

9. 新增GetEnableReconnectNetgame(客户端)， 获取是否允许断线重连

10. 新增OpenInventoryGui(客户端)， 打开原版背包界面

11. 新增CreateEngineEffectBind(客户端)， 指用编辑器保存资源包中models/bind/xxx_bind.json生成编辑好的所有挂点的所有特效

12. 新增RegisterOnStandOn(服务端)， 可以动态注册与修改原版方块的netease:on_stand_on组件(服务端接口)

13. 新增UnRegisterOnStandOn(服务端)， 可以动态删除原版方块的netease:on_stand_on组件(服务端接口)

14. 新增RegisterOnStepOn(服务端)， 可以动态注册与修改原版方块的netease:on_step_on组件(服务端接口)

15. 新增UnRegisterOnStepOn(服务端)， 可以动态删除原版方块的netease:on_step_on组件(服务端接口)

16. 新增RegisterOnStepOff(服务端)， 可以动态注册与修改原版方块的netease:on_step_off组件(服务端接口)

17. 新增UnRegisterOnStepOff(服务端)， 可以动态删除原版方块的netease:on_step_off组件(服务端接口)

18. 新增RegisterOnEntityInside(服务端)， 可以动态注册与修改原版方块的netease:on_entity_inside组件(服务端接口)

19. 新增UnRegisterOnEntityInside(服务端)， 可以动态删除原版方块的netease:on_entity_inside组件(服务端接口)

20. 新增SetDimensionUseLocalWeather(服务端)， 设置某个维度拥有自己的天气规则，开启后该维度可以拥有与其他维度不同的天气和天气更替的规则

21. 新增GetDimensionUseLocalWeather(服务端)， 获取某个维度是否拥有自己的天气规则

22. 新增SetDimensionLocalRain(服务端)， 设置某个维度下雨(必须先使用SetDimensionUseLocalWeather接口设置此维度拥有自己的独立天气)

23. 新增SetDimensionLocalThunder(服务端)， 设置某个维度打雷(必须先使用SetDimensionUseLocalWeather接口设置此维度拥有自己的独立天气)

24. 新增SetDimensionLocalDoWeatherCycle(服务端)， 设置某个维度是否开启天气循环(必须先使用SetDimensionUseLocalWeather接口设置此维度拥有自己的独立天气)

25. 新增GetDimensionLocalWeatherInfo(服务端)， 获取独立维度天气信息(必须先使用SetDimensionUseLocalWeather接口设置此维度拥有自己的独立天气)

26. 新增RegisterOnStandOn(客户端)， 可以动态注册与修改原版方块的netease:on_stand_on组件（客户端接口）

27. 新增UnRegisterOnStandOn(客户端)， 可以动态删除原版方块的netease:on_stand_on组件（客户端接口）

28. 新增RegisterOnStepOn(客户端)， 可以动态注册与修改原版方块的netease:on_step_on组件（客户端接口）

29. 新增UnRegisterOnStepOn(客户端)， 可以动态删除原版方块的netease:on_step_on组件（客户端接口）

30. 新增RegisterOnStepOff(客户端)， 可以动态注册与修改原版方块的netease:on_step_off组件（客户端接口）

31. 新增UnRegisterOnStepOff(客户端)， 可以动态删除原版方块的netease:on_step_off组件（客户端接口）

32. 新增RegisterOnEntityInside(客户端)， 可以动态注册与修改原版方块的netease:on_entity_inside组件（客户端接口）

33. 新增UnRegisterOnEntityInside(客户端)， 可以动态删除原版方块的netease:on_entity_inside组件（客户端接口）

34. 新增SetEnableGaussianBlur(客户端)， 是否开启高斯模糊效果

35. 新增CheckGaussianBlurEnabled(客户端)， 检测是否开启高斯模糊效果

36. 新增SetGaussianBlurRadius(客户端)， 设置高斯模糊效果的模糊半径

37. 新增SetEnableColorAdjustment(客户端)， 是否开启色彩校正效果

38. 新增CheckColorAdjustmentEnabled(客户端)， 检测是否开启色彩校正效果

39. 新增SetColorAdjustmentBrightness(客户端)， 调整屏幕色彩亮度值

40. 新增SetColorAdjustmentSaturation(客户端)， 调整屏幕色彩饱和度

41. 新增SetColorAdjustmentContrast(客户端)， 调整屏幕色彩对比度

42. 新增SetColorAdjustmentTint(客户端)， 调整屏幕色彩的色调

43. 新增SetEnableLensStain(客户端)， 是否开启镜头污迹效果

44. 新增CheckLensStainEnabled(客户端)， 检测是否开启镜头污迹效果

45. 新增SetLensStainTexture(客户端)， 改变镜头污迹所使用的贴图

46. 新增ResetLensStainTexture(客户端)， 重置镜头污迹所使用的贴图为系统默认贴图

47. 新增SetLensStainIntensity(客户端)， 调整镜头污迹强度

48. 新增SetLensStainColor(客户端)， 调整镜头污迹颜色

49. 新增SetEnableDepthOfField(客户端)， 是否开启景深效果

50. 新增CheckDepthOfFieldEnabled(客户端)， 检测是否开启景深效果

51. 新增SetDepthOfFieldFocusDistance(客户端)， 调整景深效果焦点距离

52. 新增SetDepthOfFieldBlurRadius(客户端)， 调整景深效果模糊半径

53. 新增SetDepthOfFieldNearBlurScale(客户端)， 调整景深效果近景模糊大小

54. 新增SetDepthOfFieldFarBlurScale(客户端)， 调整景深效果远景模糊大小

55. 新增SetDepthOfFieldUseCenterFocus(客户端)， 设置景深效果是否开启屏幕中心聚焦模式

56. 新增ModelCreateMinecraftObject(客户端)， 在虚拟世界中创建微软原版模型

57. 新增ModelUpdateAnimationMolangVariable(客户端)， 更新微软原版模型表达式变量，可控制动作的改变

58. 新增asNeteaseComboBox(客户端)， UI面向对象

59. 新增AddOption(客户端)， 添加下拉框项

60. 新增ClearOptions(客户端)， 清空下拉框

61. 新增ClearSelection(客户端)， 清除当前选中

62. 新增GetOptionIndexByShowName(客户端)， 根据展示文本查找对应下拉框项的索引位置

63. 新增GetOptionShowNameByIndex(客户端)， 根据索引位置查找当前栈式文本

64. 新增GetOptionCount(客户端)， 获得选项数量

65. 新增GetSelectOptionIndex(客户端)， 获得当前选中项的索引

66. 新增GetSelectOptionShowName(客户端)， 获得当前选中项的展示文本

67. 新增RemoveOptionByShowName(客户端)， 根据提供的展示文本移除对应下拉框项

68. 新增RemoveOptionByIndex(客户端)， 根据提供的索引移除对应下拉框项

69. 新增SetSelectOptionByIndex(客户端)， 根据提供的索引移除对应下拉框项

70. 新增SetSelectOptionByShowName(客户端)， 根据提供的展示文本选中对应下拉框项

71. 新增RegisterOpenComboBoxCallback(客户端)， 注册展开下拉框事件回调

72. 新增RegisterCloseComboBoxCallback(客户端)， 注册关闭下拉框事件回调

73. 新增RegisterSelectItemCallback(客户端)， 注册选中下拉框内容事件回调

74. 新增StepOffBlockServerEvent(服务端)， 新增实体移动离开一个实心方块时触发的事件

75. 新增PlayerIntendLeaveServerEvent(服务端)， 即将删除玩家事件，此时可以通过各种API获取玩家的当前状态。

76. 新增OnEntityInsideBlockServerEvent(服务端)， 增加当实体碰撞盒所在区域有方块时服务端持续触发的事件

77. 新增OnLocalRainLevelChangeServerEvent(服务端)， 独立维度天气下雨强度发生改变时触发

78. 新增OnLocalLightningLevelChangeServerEvent(服务端)， 独立维度天气打雷强度发生改变时触发

79. 新增StepOffBlockClientEvent(客户端)， 新增实体移动离开一个实心方块时触发的事件

80. 新增OnEntityInsideBlockClientEvent(客户端)， 增加当实体碰撞盒所在区域有方块时客户端持续触发的事件

81. 新增PlayerTryDropItemClientEvent(客户端)， 新增客户端玩家尝试丢弃物品的事件。

82. 新增InventoryType， 添加自定义分页枚举

• 调整

1. 调整PlaceStructure(服务端)， 添加默认参数rotation，默认为0，可将放置的结构体沿y轴进行旋转

2. 调整GetRecipesByResult(服务端)， 熔炉配方支持返回输出物品的数量

3. 调整GetRecipesByInput(服务端)， 熔炉配方支持返回输出物品的数量

4. 调整GetRecipesByResult(客户端)， 熔炉配方支持返回输出物品的数量

5. 调整GetRecipesByInput(客户端)， 熔炉配方支持返回输出物品的数量

6. 调整SetToggleState(客户端)， 新增参数，可调整toggle路径

7. 调整ServerSpawnMobEvent(服务端)， 新增realIdentifier参数

8. 调整StepOnBlockServerEvent(服务端)， 重大触发机制调整、备注说明更新

9. 调整OnStandOnBlockServerEvent(服务端)， 增加了cancel、dimensionId参数，优化了备注文档说明

10. 调整StepOnBlockClientEvent(客户端)， 重大触发机制调整、备注说明更新

11. 调整OnStandOnBlockClientEvent(客户端)， 新增cancel、dimensionId参数

• 修复

1. 修复SetPlayerGameType(服务端)， 修复了在AddServerPlayerEvent中使用会导致崩溃的问题

2. 修复PerspChangeClientEvent(客户端)， 修复了在设置界面切换视角时不会触发该事件的问题

• 废弃（将在未来不可用）

1. 废弃CreateEngineEffect，请使用CreateEngineEffectBind

2. 废弃ClearPlayerOffHand，已废弃，请使用SetEntityItem，itemDict传None即可

3. 废弃SetInvItemDurability，已废弃，请使用SetItemDurability

4. 废弃GetInvItemDurability，已废弃，请使用GetItemDurability

5. 废弃SetEquItemDurability，已废弃，请使用SetItemDurability

6. 废弃GetEquItemDurability，已废弃，请使用GetItemDurability