3.4
2025.5.22:版本号(V3.4 BE1.21.00)包括Mod PC包,手机测试版启动器,和服务器引擎。
示例Demo:前往此处下载
一、更新时间表
- 在2025年5月22日上线3.4第一个Beta版。
- 在2025年6月05日上线3.4第二个Beta版。
- 在2025年6月17日上线3.4稳定版。
- 在2025年6月27日,全渠道将更新3.4版本玩家包体,玩家将陆续更新到3.4版本,请开发者合理安排更新节奏。
二、重要功能更新
新增自定义容器,可以实现自定义容器界面,支持配置其他方块组件(如自定义实体方块组件)、容器名、交互时打开的自定义ui、以及自定义容器的大小等
新增PlayerTryPutCustomContainerItemServerEvent(服务端)用于监听玩家将物品放入自定义容器
ClientItemTryUseEvent(客户端)、ClientItemUseOnEvent(客户端)、ClientBlockUseEvent(客户端)事件逻辑性调整。三个事件cancel时即可取消使用,无需服务端再次cancel,且服务端事件将不再触发
调整LockCamera(客户端)与AddCameraTrackMotion(客户端)支持roll旋转
SpawnResources增加掉落经验球参数,设成True时按原版采集逻辑进行经验球掉落,如矿石类方块会产生随机数量的经验球
新增GetPlayerCurrentExhaustionValue(服务端)、SetPlayerCurrentExhaustionValue(服务端) 获取和设置玩家当前消耗度
方块实体模型的渲染消失问题修复,现在将根据netease:aabb组件中clip字段作为裁减碰撞盒,开发者可以自行配置netease:aabb组件中clip字段大小控制模型显示大小
新版视角切换按钮贴图位于/textures/ui/perspective.png,材质包开发者请留意提前适配
三、API更新
- 新增
新增GetIntPos(服务端), 获取坐标所在方块的位置
新增GetHostPlayerId(服务端), 获取房主的entityId
新增GetIntPos(客户端), 获取坐标所在方块的位置
新增GetHostPlayerId(客户端), 获取房主的entityId
新增GetPlayerCurrentExhaustionValue(服务端), 获取玩家当前消耗度
新增SetPlayerCurrentExhaustionValue(服务端), 设置玩家当前消耗度
新增GetPropertyBag(客户端), 获取PropertyBag
新增SetPropertyBag(客户端), 设置PropertyBag
新增ChunkGeneratedServerEvent(服务端), 新增chunkPosX,chunkPosZ
新增PlayerTryPutCustomContainerItemServerEvent(服务端), 玩家尝试将物品放入自定义容器时触发该事件
- 调整
调整HideSwimGui(客户端), 修改接口描述, 隐藏潜伏按钮
调整SpawnResources(服务端), 新增是否生成经验球参数,默认为False,设成True时按原版采集逻辑进行经验球掉落,如矿石类方块会产生随机数量的经验球
调整GetItemBasicInfo(服务端), 新增字段,enchant_slot_type
调整SetPos(服务端), 修改文档类型描述
调整GetActorRenderParams(客户端), 修复返回数据
调整LockCamera(客户端), lockRot支持roll旋转
调整AddCameraTrackMotion(客户端), targetRot和startRot支持roll旋转
调整GetItemBasicInfo(客户端), 新增字段,enchant_slot_type
调整ServerItemTryUseEvent(服务端), ClientItemTryUseEvent的cancel设置为True时,服务端事件不会被触发了。
调整ServerItemUseOnEvent(服务端), 客户端事件ClientItemUseOnEvent设置ret设置为True时,服务端不再会接受到这个事件。
调整BlockStrengthChangedServerEvent(服务端), 新增变化前的红石信号量参数
调整ClientItemTryUseEvent(客户端), ClientItemTryUseEvent事件设置cancel为True时,不会再给服务端同步物品使用网络包。
调整ClientItemUseOnEvent(客户端), ClientItemUseOnEvent事件设置ret为True时,不会再给服务端同步物品使用网络包。
调整ClientBlockUseEvent(客户端), 当拦截交互逻辑时,不再会给服务端发送网络包,
调整BlockAnimateRandomTickEvent(客户端), 新增blockName与auxData参数
调整ActorDamageCause, 微软把suicide改成了self_destruct
调整OriginGUIName, 增加摄像机视角按钮