Skip to content

3.4

2025.5.22:版本号(V3.4 BE1.21.00)包括Mod PC包,手机测试版启动器,和服务器引擎。

示例Demo:前往此处下载

一、更新时间表

  1. 在2025年5月22日上线3.4第一个Beta版。
  2. 在2025年6月05日上线3.4第二个Beta版。
  3. 在2025年6月17日上线3.4稳定版。
  4. 在2025年6月27日,全渠道将更新3.4版本玩家包体,玩家将陆续更新到3.4版本,请开发者合理安排更新节奏。

二、重要功能更新

  1. 新增自定义容器,可以实现自定义容器界面,支持配置其他方块组件(如自定义实体方块组件)、容器名、交互时打开的自定义ui、以及自定义容器的大小等

  2. 新增PlayerTryPutCustomContainerItemServerEvent(服务端)用于监听玩家将物品放入自定义容器

  3. ClientItemTryUseEvent(客户端)、ClientItemUseOnEvent(客户端)、ClientBlockUseEvent(客户端)事件逻辑性调整。三个事件cancel时即可取消使用,无需服务端再次cancel,且服务端事件将不再触发

  4. 调整LockCamera(客户端)与AddCameraTrackMotion(客户端)支持roll旋转

  5. SpawnResources增加掉落经验球参数,设成True时按原版采集逻辑进行经验球掉落,如矿石类方块会产生随机数量的经验球

  6. 新增GetPlayerCurrentExhaustionValue(服务端)、SetPlayerCurrentExhaustionValue(服务端) 获取和设置玩家当前消耗度

  7. 方块实体模型的渲染消失问题修复,现在将根据netease:aabb组件中clip字段作为裁减碰撞盒,开发者可以自行配置netease:aabb组件中clip字段大小控制模型显示大小

  8. 新版视角切换按钮贴图位于/textures/ui/perspective.png,材质包开发者请留意提前适配

三、API更新

  • 新增
  1. 新增GetIntPos(服务端), 获取坐标所在方块的位置

  2. 新增GetHostPlayerId(服务端), 获取房主的entityId

  3. 新增GetIntPos(客户端), 获取坐标所在方块的位置

  4. 新增GetHostPlayerId(客户端), 获取房主的entityId

  5. 新增GetPlayerCurrentExhaustionValue(服务端), 获取玩家当前消耗度

  6. 新增SetPlayerCurrentExhaustionValue(服务端), 设置玩家当前消耗度

  7. 新增GetPropertyBag(客户端), 获取PropertyBag

  8. 新增SetPropertyBag(客户端), 设置PropertyBag

  9. 新增ChunkGeneratedServerEvent(服务端), 新增chunkPosX,chunkPosZ

  10. 新增PlayerTryPutCustomContainerItemServerEvent(服务端), 玩家尝试将物品放入自定义容器时触发该事件

  • 调整
  1. 调整HideSwimGui(客户端), 修改接口描述, 隐藏潜伏按钮

  2. 调整SpawnResources(服务端), 新增是否生成经验球参数,默认为False,设成True时按原版采集逻辑进行经验球掉落,如矿石类方块会产生随机数量的经验球

  3. 调整GetItemBasicInfo(服务端), 新增字段,enchant_slot_type

  4. 调整SetPos(服务端), 修改文档类型描述

  5. 调整GetActorRenderParams(客户端), 修复返回数据

  6. 调整LockCamera(客户端), lockRot支持roll旋转

  7. 调整AddCameraTrackMotion(客户端), targetRot和startRot支持roll旋转

  8. 调整GetItemBasicInfo(客户端), 新增字段,enchant_slot_type

  9. 调整ServerItemTryUseEvent(服务端), ClientItemTryUseEvent的cancel设置为True时,服务端事件不会被触发了。

  10. 调整ServerItemUseOnEvent(服务端), 客户端事件ClientItemUseOnEvent设置ret设置为True时,服务端不再会接受到这个事件。

  11. 调整BlockStrengthChangedServerEvent(服务端), 新增变化前的红石信号量参数

  12. 调整ClientItemTryUseEvent(客户端), ClientItemTryUseEvent事件设置cancel为True时,不会再给服务端同步物品使用网络包。

  13. 调整ClientItemUseOnEvent(客户端), ClientItemUseOnEvent事件设置ret为True时,不会再给服务端同步物品使用网络包。

  14. 调整ClientBlockUseEvent(客户端), 当拦截交互逻辑时,不再会给服务端发送网络包,

  15. 调整BlockAnimateRandomTickEvent(客户端), 新增blockName与auxData参数

  16. 调整ActorDamageCause, 微软把suicide改成了self_destruct

  17. 调整OriginGUIName, 增加摄像机视角按钮