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

2.2

2022.6.21：版本号（v2.2 BE1.18.0）

包括Mod PC包，手机测试版启动器，和服务器引擎。

• 温馨提示

在6月7日，上线2.2第一个beta版。

在6月21日，上线2.2第二个beta版。

在6月30日，上线2.2的稳定版。

在7月8日，全渠道将更新2.2版本玩家包体，玩家将陆续更新到2.2版本，请开发者合理安排更新节奏。

下载2.2 Demo。

• 新增重大功能介绍

1. 新增对微软粒子的创建，播放控制和挂接支持，详见微软粒子

2. 自定义方块自由模型的每张贴图支持最大64×64，关于自定义方块模型的制作请参考这篇文档。

3. 方块几何体模型支持门、床、活塞、粘性活塞、告示牌、箱子类方块

4. 自定义方块及自定义方块模型的群系颜色，详见 这篇文档

5. 部分UI控件支持属性动画，详见 这篇文档 。

6. 新增自定义成就系统，支持开发者定义自己的成就事件并展示，详见自定义成就

​

• 特殊说明

自定义维度中，如果使用了群系地貌（netease_biomes目录中定义），则默认使用2d群系规则。

注：在2.2以及之后的版本，我们对自定义生物的移动流量进行了优化，距离玩家较远的生物会出现瞬移的情况，如果感觉效果较差，可在components手动添加netease:ban_bandwidth_optimization:{}组件来主动关闭此优化

• 新增

1. 新增GetRotFromDir(服务端)， 通过玩家当前朝向获取旋转角度

2. 新增GetRotFromDir(客户端)， 通过玩家当前朝向获取旋转角度

3. 新增GetNodeDetailInfo(服务端)， 获取自定义成就系统的成就节点信息的接口

4. 新增SetNodeFinish(服务端)， 设置自定成就系统某个成就节点完成的接口

5. 新增AddNodeProgress(服务端)， 添加自定义成就系统成就节点进度的接口

6. 新增GetChildrenNode(服务端)， 获得自定义成就系统中某成就节点的下一级所有孩子节点的接口

7. 新增LobbyGetAchievementStorage(服务端)， 获取云成就存储进度的数据接口

8. 新增LobbySetAchievementStorage(服务端)， 添加云成就成就进度的数据接口

9. 新增SetActorBlockGeometryOffset(客户端)， 设置实体的方块几何体模型的位置偏移。

10. 新增SetActorBlockGeometryRotation(客户端)， 设置实体的方块几何体模型的旋转角度。

11. 新增EnableActorBlockGeometryTransparent(客户端)， 设置是否允许实体的方块几何体模型产生透明度。

12. 新增SetActorBlockGeometryTransparency(客户端)， 设置实体的方块几何体模型的透明度。

13. 新增Create(客户端)， 创建粒子发射器

14. 新增CreateBindEntity(客户端)， 创建粒子发射器并绑定实体

15. 新增EmitManually(客户端)， 手动发射粒子

16. 新增BindEntity(客户端)， 绑定粒子发射器到指定实体

17. 新增Unbind(客户端)， 解除粒子发射器绑定

18. 新增SetRelative(客户端)， 设置粒子是否在局部空间进行计算

19. 新增GetBindingID(客户端)， 获取粒子发射器绑定的目标ID

20. 新增Remove(客户端)， 销毁指定粒子发射器

21. 新增RemoveByName(客户端)， 销毁所有具有指定identifier的粒子发射器

22. 新增Exist(客户端)， 判断指定粒子发射器是否存在

23. 新增Play(客户端)， 播放粒子发射器

24. 新增Stop(客户端)， 停止粒子发射器播放

25. 新增Hide(客户端)， 隐藏粒子发射器

26. 新增Show(客户端)， 显示粒子发射器

27. 新增Pause(客户端)， 暂停粒子发射器更新

28. 新增Resume(客户端)， 恢复粒子发射器更新

29. 新增Replay(客户端)， 重播粒子发射器

30. 新增PlayAt(客户端)， 设置粒子发射器播放时间点

31. 新增IsPausing(客户端)， 判断粒子发射器是否被暂停

32. 新增IsHiding(客户端)， 判断粒子发射器是否被隐藏

33. 新增SetPos(客户端)， 设置粒子发射器位置

34. 新增GetPos(客户端)， 获取粒子发射器位置

35. 新增SetRot(客户端)， 设置粒子发射器旋转

36. 新增GetRot(客户端)， 获取粒子发射器旋转

37. 新增SetTimeScale(客户端)， 设置粒子发射器播放速度

38. 新增GetTimeScale(客户端)， 获取粒子发射器播放速度

39. 新增GetDuration(客户端)， 获取粒子发射器播放周期

40. 新增GetActiveDuration(客户端)， 获取粒子发射器激活周期

41. 新增GetSleepDuration(客户端)， 获取粒子发射器休眠周期

42. 新增GetLoopAge(客户端)， 获取粒子发射器周期内已播放时间

43. 新增GetVariable(客户端)， 获取粒子发射器的Molang变量值

44. 新增SetVariable(客户端)， 设置粒子发射器的Molang变量值

45. 新增GetFacingMode(客户端)， 返回粒子发射器的粒子朝向模式

46. 新增resetAnimation(客户端)， 重置该控件的动画

47. 新增SetButtonScreenExitCallback(客户端)， 设置按钮所在画布退出时若鼠标仍未抬起时触发回调函数

48. 新增SetOffsetDelta(客户端)， 设置点击面板的拖拽偏移量

49. 新增GetOffsetDelta(客户端)， 获得点击面板的拖拽偏移量

50. 新增OnMobHitMobServerEvent(服务端)， 生物碰撞事件

51. 新增OnMobHitMobClientEvent(客户端)， 生物碰撞事件

• 调整

1. 调整SetPlayerRideEntity(服务端)， 支持骑乘船与矿车

2. 调整SetRiderRideEntity(服务端)， 支持骑乘船与矿车

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

1. 废弃OnPlayerHitMobServerEvent，添加了新事件OnMobHitMobServerEvent代替该事件

2. 废弃OnPlayerHitMobClientEvent，添加了新事件OnMobHitMobClientEvent代替该事件