6.2 KiB
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， 增加摄像机视角按钮