# 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，材质包开发者请留意提前适配
微软在1.21.00继续修改了部分方块ID，如树叶、台阶等，详见3.4版本物品id变更，相关链接请参阅基岩版扁平化 (opens new window)，请开发者注意适配。
# 三、API更新
- 新增
新增GetIntPos(服务端)， 获取坐标所在方块的位置
新增GetHostPlayerId(服务端)， 获取房主的entityId
新增GetIntPos(客户端)， 获取坐标所在方块的位置
新增GetHostPlayerId(客户端)， 获取房主的entityId
新增GetPlayerCurrentExhaustionValue(服务端)， 获取玩家当前消耗度
新增SetPlayerCurrentExhaustionValue(服务端)， 设置玩家当前消耗度
新增IsOfficialSkin(客户端)， 获取玩家穿戴的皮肤是否为官方4d皮肤
新增IsHighLevelOfficialSkin(客户端)， 获取玩家穿戴的皮肤是否为史诗及以上的官方4d皮肤
新增IsHighLevelMultiJointOfficialSkin(客户端)， 获取玩家穿戴的皮肤是否为史诗及以上的多关节官方4d皮肤
新增GetPropertyBag(客户端)， 获取PropertyBag
新增SetPropertyBag(客户端)， 设置PropertyBag
新增ChunkGeneratedServerEvent(服务端)， 新增chunkPosX,chunkPosZ
新增PlayerTryPutCustomContainerItemServerEvent(服务端)， 玩家尝试将物品放入自定义容器时触发该事件
- 调整
调整HideSwimGui(客户端)， 修改接口描述, 隐藏潜伏按钮
调整SpawnResources(服务端)， 新增是否生成经验球参数，默认为False，设成True时按原版采集逻辑进行经验球掉落，如矿石类方块会产生随机数量的经验球
调整GetItemBasicInfo(服务端)， 新增字段，enchant_slot_type
调整GetActorRenderParams(客户端)， 修复返回数据
调整LockCamera(客户端)， lockRot支持roll旋转
调整AddCameraTrackMotion(客户端)， targetRot和startRot支持roll旋转
调整GetItemBasicInfo(客户端)， 新增字段，enchant_slot_type
调整ServerBlockUseEvent(服务端)， 客户端对应事件ClientBlockUseEvent如果开启拦截开关，则服务端也不会收到对应事件，即ServerBlockUseEvent不会触发。
调整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， 增加摄像机视角按钮