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

2.4

2022.11.08：版本号（v2.4 BE1.18.0）

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

温馨提示

1. 在10月27日，上线2.4第一个beta版。

2. 在11月8日，上线2.4的稳定版。

3. 在11月25日，全渠道将更新2.4版本玩家包体，玩家将陆续更新到2.4版本，请开发者合理安排更新节奏。

4. 下载2.4 Demo。

重大功能介绍

1. 实体&玩家运动器接口

对实体和玩家分别新增了三套不同类型的运动器接口，可用于控制实体玩家的运动轨迹：

1. 轨迹运动器：用于驱动实体、玩家从一点到另一点的直线运动。

2. 速度运动器：用于驱动实体、玩家根据初速度和加速度进行匀速/变速运动。

3. 环绕运动器：用于驱动实体、玩家环绕指定坐标或指定实体运动。

详情请参考实体运动器接口和玩家运动器接口

2. 自定义地形高度：增加替换节点

新增了1种高度控制节点：替换节点，开发者可将其配置在群系配置文件中，灵活控制和替换地形中的方块。 例如下图就是使用新版的替换节点实现的效果。

详情参考这篇文档。

3. 原生UI控制接口补充

1. 新增了一系列接口，补充了对原生UI的动态开启/关闭支持,详见接口原生UI
2. 新增了获取和弹出所有UI堆栈顶的接口，覆盖支持了自定义UI和原生UI两种类型，详见接口GetTopUI

4. UI支持渲染方块网格体

新增了渲染方块网格体模型接口，支持将方块网格体数据渲染至UI，可配合纸娃娃控件达成拖拽旋转效果。

API改动

新增

1. 新增HidePauseGUI(客户端)， 隐藏暂停按钮原生UI

2. 新增HideChatGUI(客户端)， 隐藏聊天按钮原生UI

3. 新增HideReportGUI(客户端)， 隐藏举报按钮原生UI

4. 新增HideFoldGUI(客户端)， 隐藏下拉按钮原生UI

5. 新增HideEmoteGUI(客户端)， 打开表情界面

6. 新增HideVoiceGUI(客户端)， 隐藏语音按钮原生UI

7. 新增GetTopUI(客户端)， 获取UI堆栈栈顶的UI名称，可获得原生UI也可获得PushScreen生成的UI

8. 新增PopTopUI(客户端)， 弹出UI堆栈栈顶的UI

9. 新增OpenPauseGui(客户端)， 打开原版暂停界面

10. 新增OpenFoldGui(客户端)， 打开原版下拉界面

11. 新增OpenVoiceGui(客户端)， 打开原版语音界面

12. 新增OpenReportGui(客户端)， 打开原版举报界面

13. 新增OpenEmoteGui(客户端)， 打开表情界面

14. 新增AddEntityTrackMotion(服务端)， 给实体（不含玩家）添加轨迹运动器

15. 新增AddEntityVelocityMotion(服务端)， 给实体（不含玩家）添加速度运动器

16. 新增AddEntityAroundPointMotion(服务端)， 给实体（不含玩家）添加对点环绕运动器

17. 新增AddEntityAroundEntityMotion(服务端)， 给实体（不含玩家）添加对实体环绕运动器

18. 新增GetEntityMotions(服务端)， 获取实体（不含玩家）身上所有运动器

19. 新增RemoveEntityMotion(服务端)， 移除实体（不含玩家）身上的运动器

20. 新增StartEntityMotion(服务端)， 启动实体（不含玩家）身上的某个运动器

21. 新增StopEntityMotion(服务端)， 停止实体（不含玩家）身上的某个运动器

22. 新增AddPlayerTrackMotion(服务端)， 给玩家添加轨迹运动器

23. 新增AddPlayerVelocityMotion(服务端)， 给玩家添加速度运动器

24. 新增AddPlayerAroundPointMotion(服务端)， 给玩家添加对点环绕运动器

25. 新增AddPlayerAroundEntityMotion(服务端)， 给玩家添加对实体环绕运动器

26. 新增GetPlayerMotions(服务端)， 获取玩家身上所有运动器

27. 新增RemovePlayerMotion(服务端)， 移除玩家身上的运动器

28. 新增StartPlayerMotion(服务端)， 启动玩家身上的某个运动器

29. 新增StopPlayerMotion(服务端)， 停止玩家身上的某个运动器

30. 新增HideShopGate(客户端)， 隐藏网易商城入口

31. 新增ShowShopGate(客户端)， 显示网易商城入口

32. 新增OpenShopWindow(客户端)， 打开网易商城窗口

33. 新增OpenItemDetailWindow(客户端)， 打开特定商品的详情界面

34. 新增CloseShopWindow(客户端)， 关闭网易商城窗口

35. 新增RenderBlockGeometryModel(客户端)， 渲染网格体模型

36. 新增EntityMotionStartServerEvent(服务端)， 实体运动器开始事件

37. 新增EntityMotionStopServerEvent(服务端)， 实体运动器停止事件

38. 新增UrgeShipEvent(服务端)， 玩家点击商城催促发货按钮时触发该事件

39. 新增InputMode， 控制器输入模式

40. 新增UICategory， 原生UI类型名

调整

1. 调整GetItemBasicInfo(服务端)， 新增燃料时间，食物饱食度，食物营养值，武器攻击力，防具防御力字段

2. 调整GetItemBasicInfo(客户端)， 新增燃料时间，食物饱食度，食物营养值，武器攻击力，防具防御力字段

3. 调整ServerSpawnMobEvent(服务端)， 新增entityId返回参数

4. 调整AddPlayerCreatedClientEvent(客户端)， 调整事件触发时机，并对localPlayer也起效