3.8

2026.3.31：版本号（V3.8 BE1.21.90）包括Mod PC包，手机测试版启动器，和服务器引擎。

示例Demo：前往此处下载

一、更新时间表

1. 在2026年4月01日上线3.8第一个Beta版。有以下注意事项
   • 3.8包体暂时无法使用本地联机，请等待后续修复
2. 在2026年4月09日上线3.8第二个Beta版。
3. 在2026年4月22日上线3.8稳定版。
4. 在2026年4月24日，全渠道将更新3.8版本玩家包体，玩家将陆续更新到3.8版本，请开发者合理安排更新节奏。

二、重要功能更新

1. 物理系统

   • 注意：物理系列的接口为实验性内容，在后期版本中可能会存在接口变更、开发环境变更等情况。请各位开发者合理安排开发内容与正式版本，避免后续版本物理系统更新后出现模组失效的情况
   • 新增AddForceAtPos(服务端)、AddForceAtPosLocal(服务端)，对自定义刚体的指定位置添加力，对运动学刚体无效
   • 新增AddBoxTrigger(服务端)， 给自定义刚体创建盒子形触发器；新增PhysxTriggerClientEvent(客户端)， 给自定义刚体添加的触发器，与其他碰撞体或原版实体进入/离开触发器时触发。需要在触发器创建时使用PxEventMask.Client才会触发
   • 新增AddCapsuleGeometry(服务端)、AddSphereGeometry(服务端)， 给自定义刚体创建胶囊形、球形碰撞体
   • 物理系统相关教程请见物理的使用指南

2. 钓鱼模块

   • 本次对钓鱼模块添加了诸多支持，新增json组件自定义鱼竿功能，可以自定义鱼漂、鱼线等，开发者详见自定义鱼竿查看
   • 新增事件：
     • 新增PlayerFishingServerEvent(服务端)， 钓鱼成功收杆时触发
     • 新增PlayerFishingAfterServerEvent(服务端)， 钓鱼成功收杆后触发
   • 鱼线支持
     • 新增SetFishingLineMax(服务端)， 服务端设置钓鱼线最大长度，超过这个长度线将会自动断裂；新增GetFishingLineMax(服务端)， 服务端获取钓鱼线的最大长度
     • 新增SetFishingLineColor(服务端)， 服务端设置钓鱼线的颜色；新增GetFishingLineColor(服务端)， 服务端获取钓鱼线的颜色，如没有接口设置，则获取的是自定义鱼竿中json中的颜色
   • 新增钓鱼状态接口：GetPlayerIsFishing(服务端)，获取玩家是否在钓鱼；新增GetPlayerFishHookEntity(服务端)，获取玩家钓鱼时候的鱼漂实体id；新增GetPlayerFishItem(服务端) 获取玩家钓鱼时候的鱼竿物品字典

3. 自定义流体事件

   • 新增LiquidClippedClientEvent(客户端)和服务端事件，，玩家客户端点击流体时触发（支持原版流体与自定义流体），开发可以在物品组件中添加netease:liquid_clipped: True组件才能触发，方便开发者实现与流体的交互、原版睡莲方块的的放置效果等

4. 物品附着物

   • 新增物品附着物一系列接口，可以将原版物品附着在玩家骨骼上，支持获取绑定的骨骼、设置缩放、旋转等，方便开发者实现物品武器等穿戴在身上的效果

5. 属性修饰符

   • 新增AddModifier(服务端)、UpdateModifier(服务端)、RemoveModifier(服务端)、HasModifier(服务端)接口获取、设置、更新、移除属性修饰符，帮助开发者对生物兼容性进行适配

6. 自定义容器新增支持

   • 新增事件PlayerAddCustomContainerItemClientEvent(客户端)， 玩家成功将物品添加到自定义容器时触发该事件
   • 新增事件PlayerRemoveCustomContainerItemClientEvent(客户端)， 玩家成功从自定义容器中移除物品时触发该事件
   • 自定义容器hopper字段新增output_slot，类型为list。当"output": true时代表output_slot字段生效，"output_slot": [1,10] 代表1和10支持漏出，其余的不支持，详细请前往自定义容器

7. 其他新增接口

   • 新增UseItemToPos(服务端)， 对某个方块使用指定物品
   • 新增ResetEntityExtraSkin(客户端)， 一键还原实体额外皮肤组件，方便开发者用于自定义玩家模型动画后的一键还原

8. 接口优化

   • Item相关接口支持设置获取收纳袋，详情请见下文中调整

• 新增

1. 新增AddModifier(服务端)， 属性修饰符控制与创建

2. 新增UpdateModifier(服务端)， 属性修饰符控制与创建

3. 新增RemoveModifier(服务端)， 属性修饰符控制与创建

4. 新增HasModifier(服务端)， 属性修饰符控制与创建

5. 新增GetAllModifiers(服务端)， 属性修饰符控制与创建

6. 新增SetFishingLineMax(服务端)， 服务端设置钓鱼线最大长度

7. 新增GetFishingLineMax(服务端)， 服务端获取钓鱼线的最大长度

8. 新增SetFishingLineColor(服务端)， 服务端设置钓鱼线的颜色

9. 新增GetFishingLineColor(服务端)， 服务端获取钓鱼线的颜色

10. 新增UseItemToPos(服务端)， 对某个方块使用指定物品。

11. 新增GetPlayerFishHookEntity(服务端)， 获取玩家钓鱼时候的鱼漂实体id

12. 新增GetPlayerFishItem(服务端)， 获取玩家钓鱼时候的鱼竿物品字典

13. 新增AddCapsuleGeometry(服务端)， 给自定义刚体创建胶囊形碰撞体

14. 新增AddSphereGeometry(服务端)， 给自定义刚体创建球形碰撞体

15. 新增AddBoxTrigger(服务端)， 给自定义刚体创建盒子形触发器

16. 新增AddForceAtPosLocal(服务端)， 对自定义刚体的指定位置添加力，对运动学刚体无效

17. 新增AddForceAtPos(服务端)， 对自定义刚体的指定位置添加力，对运动学刚体无效

18. 新增GetPlayerIsFishing(服务端)， 获取玩家是否在钓鱼

19. 新增GetQueryableBoneOrientation(客户端)， 获取实体的原版模型指定骨骼的骨骼矩阵信息。

20. 新增ResetEntityExtraSkin(客户端)， 一键还原实体额外皮肤组件

21. 新增ResetCameraPos(客户端)， 重置相机位置模式，使相机恢复跟随玩家

22. 新增GetFishingLineMax(客户端)， 获取钓鱼线的最大长度

23. 新增GetFishingLineColor(客户端)， 获取钓鱼线的颜色

24. 新增BindItemToMinecraftModel(客户端)， 将指定物品作为附作物动态挂接到实体原版模型上，在实体原版模型上渲染指定物品。

25. 新增BindItemToSkeletonModel(客户端)， 将指定物品作为附作物动态挂接到实体的网易版骨骼模型，在实体的网易版骨骼模型上指定骨骼渲染指定物品。

26. 新增SetBindBoneForBindItem(客户端)， 改变实体上已绑定的物品附着物所绑定的骨骼，又或者移除该物品附着物。

27. 新增GetBindBoneForBindItem(客户端)， 查询获取实体上已绑定的物品附着物所绑定的骨骼名称。

28. 新增SetBindItemRotation(客户端)， 设置实体上的物品附着物相对骨骼的旋转角度。

29. 新增SetBindItemOffset(客户端)， 设置实体上的物品附着物相对骨骼的位置偏移。

30. 新增SetBindItemScale(客户端)， 设置实体上的物品附着物的缩放比例。

31. 新增GetBindItemRotation(客户端)， 查询获取实体上的物品附着物相对骨骼的旋转角度。

32. 新增GetBindItemOffset(客户端)， 查询获取实体上的物品附着物相对骨骼的位置偏移。

33. 新增GetBindItemScale(客户端)， 查询获取实体上的物品附着物的缩放比例。

34. 新增GetPlayerFishHookEntity(客户端)， 获取玩家钓鱼时候的鱼漂实体id

35. 新增GetPlayerFishItem(客户端)， 获取玩家钓鱼时候的鱼竿物品字典

36. 新增GetPlayerIsFishing(客户端)， 获取玩家是否在钓鱼

37. 新增PlayerRemoveCustomContainerItemServerEvent(服务端)， 玩家从自定义容器中移除物品成功后触发的非取消性事件

38. 新增PlayerAddCustomContainerItemServerEvent(服务端)， 玩家向自定义容器中添加物品成功后触发的非取消性事件

39. 新增LiquidClippedServerEvent(服务端)， 玩家服务端点击流体时触发（支持原版流体与自定义流体）

40. 新增PhysxTriggerServerEvent(服务端)， 给自定义刚体添加的触发器，与其他碰撞体或原版生物发生进入触发器/离开触发器时触发

41. 新增PlayerFishingServerEvent(服务端)， 钓鱼成功收杆时触发事件

42. 新增PlayerFishingAfterServerEvent(服务端)， 钓鱼成功收杆后触发事件

43. 新增PlayerStartFishingServerEvent(服务端)， 玩家开始钓鱼事件

44. 新增LiquidClippedClientEvent(客户端)， 玩家客户端点击流体时触发（支持原版流体与自定义流体）

45. 新增PlayerAddCustomContainerItemClientEvent(客户端)， 玩家成功将物品添加到自定义容器时触发该事件

46. 新增PlayerRemoveCustomContainerItemClientEvent(客户端)， 玩家成功从自定义容器中移除物品时触发该事件

47. 新增PhysxTriggerClientEvent(客户端)， 给自定义刚体添加的触发器，与其他碰撞体或原版实体进入/离开触发器时触发。需要在触发器创建时使用PxEventMask.Client才会触发

48. 新增AttributeModifierOperation， 属性修饰符操作枚举

49. 新增AttributeOperands， 属性操作数枚举

50. 新增EntityType， 新增HappyGhast(快乐恶魂)类型

51. 新增RenderLayer， 新增BLEND_TO_OPAQUE、ALPHATEST_SINGLE_SIDE_TO_OPAQUE材质类型

• 调整

1. 调整HideNeteaseStoreGui(客户端)， 补充说明

2. 调整OpenNeteaseStoreGui(客户端)， 补充说明

3. 调整SetUseLocalTime(服务端)， 当一个局部维度的睡觉玩家数量达到可以跳过黑夜的数量之后，这时会将该局部维度的时间跳到第二天早上。

4. 调整UseItemToEntity(服务端)， 适配微软新版实现逻辑。

5. 调整GetPlayerItem(服务端)， getUserData支持收纳袋

6. 调整GetPlayerAllItems(服务端)， getUserData支持收纳袋

7. 调整GetEntityItem(服务端)， getUserData支持收纳袋

8. 调整GetContainerItem(服务端)， getUserData支持收纳袋

9. 调整GetEnderChestItem(服务端)， getUserData支持收纳袋

10. 调整SetCameraPos(客户端)， 需先调用DepartCamera()接口分离相机，再调用这个接口后相机会自动进入独立位置模式，不再跟随玩家。如需恢复跟随，请调用ResetCameraPos()

11. 调整GetCarriedItem(客户端)， getUserData支持收纳袋

12. 调整GetPlayerItem(客户端)， getUserData支持收纳袋

13. 调整GetPlayerAllItems(客户端)， getUserData支持收纳袋

14. 调整SetToggleOption(客户端)， GRAPHICS选项已不支持通过此接口修改

15. 调整AttrType， 新增wiki中的属性枚举值

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

1. 废弃EntityUseItemToPos，该接口已废弃，请使用UseItemToPos。