# 3.4
2025.5.22：版本号（V3.4 BE1.21.00）包括Mod PC包，手机测试版启动器，和服务器引擎。

示例Demo：<a href="../../../mcguide/20-玩法开发/13-模组SDK编程/60-Demo示例.html" rel="noopenner">前往此处下载</a>

## 一、更新时间表

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. 新增<a href="../../../mcguide/20-玩法开发/15-自定义游戏内容/2-自定义方块/3-特殊方块/11-自定义容器.html" rel="noopenner">自定义容器</a>，可以实现自定义容器界面，支持配置其他方块组件（如自定义实体方块组件）、容器名、交互时打开的自定义ui、以及自定义容器的大小等

2. 新增[PlayerTryPutCustomContainerItemServerEvent](../事件/物品.md#playertryputcustomcontaineritemserverevent)(服务端)用于监听玩家将物品放入自定义容器

3. [ClientItemTryUseEvent](../事件/物品.md#clientitemtryuseevent)(客户端)、[ClientItemUseOnEvent](../事件/物品.md#clientitemuseonevent)(客户端)、[ClientBlockUseEvent](../事件/方块.md#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，材质包开发者请留意提前适配

9. 微软在1.21.00继续修改了部分方块ID，如树叶、台阶等，详见<a href="../../../mcguide/20-玩法开发/13-模组SDK编程/2-Python脚本开发/102-3.4版本物品id变更.html" rel="noopenner">3.4版本物品id变更</a>，相关链接请参阅[基岩版扁平化](https://zh.minecraft.wiki/w/%E5%AE%98%E6%96%B9%E9%A1%B5%E9%9D%A2/%E5%9F%BA%E5%B2%A9%E7%89%88%E6%89%81%E5%B9%B3%E5%8C%96)，请开发者注意适配。


## 三、API更新

- 新增

1. 新增[GetIntPos](../接口/通用/数学.md#getintpos)(服务端)， 获取坐标所在方块的位置<!--by lrz-->

1. 新增[GetHostPlayerId](../接口/通用/工具.md#gethostplayerid)(服务端)， 获取房主的entityId<!--by lrz-->

1. 新增[GetIntPos](../接口/通用/数学.md#getintpos)(客户端)， 获取坐标所在方块的位置<!--by lrz-->

1. 新增[GetHostPlayerId](../接口/通用/工具.md#gethostplayerid)(客户端)， 获取房主的entityId<!--by lrz-->

1. 新增[GetPlayerCurrentExhaustionValue](../接口/玩家/属性.md#getplayercurrentexhaustionvalue)(服务端)， 获取玩家当前消耗度<!--by qiuyukun-->

1. 新增[SetPlayerCurrentExhaustionValue](../接口/玩家/属性.md#setplayercurrentexhaustionvalue)(服务端)， 设置玩家当前消耗度<!--by qiuyukun-->

1. 新增[IsOfficialSkin](../接口/玩家/属性.md#isofficialskin)(客户端)， 获取玩家穿戴的皮肤是否为官方4d皮肤<!--by slp-->

1. 新增[IsHighLevelOfficialSkin](../接口/玩家/属性.md#ishighlevelofficialskin)(客户端)， 获取玩家穿戴的皮肤是否为史诗及以上的官方4d皮肤<!--by slp-->

1. 新增[IsHighLevelMultiJointOfficialSkin](../接口/玩家/属性.md#ishighlevelmultijointofficialskin)(客户端)， 获取玩家穿戴的皮肤是否为史诗及以上的多关节官方4d皮肤<!--by slp-->

1. 新增[GetPropertyBag](../接口/自定义UI/UI控件.md#getpropertybag)(客户端)， 获取PropertyBag<!--by qiuyukun-->

1. 新增[SetPropertyBag](../接口/自定义UI/UI控件.md#setpropertybag)(客户端)， 设置PropertyBag<!--by qiuyukun-->

1. 新增[ChunkGeneratedServerEvent](../事件/世界.md#chunkgeneratedserverevent)(服务端)， 新增chunkPosX,chunkPosZ<!--by qiuyukun-->

1. 新增[PlayerTryPutCustomContainerItemServerEvent](../事件/物品.md#playertryputcustomcontaineritemserverevent)(服务端)， 玩家尝试将物品放入自定义容器时触发该事件<!--by lidi-->

- 调整

1. 调整[HideSwimGui](../接口/原生UI.md#hideswimgui)(客户端)， 修改接口描述, 隐藏潜伏按钮<!--by jiaoshe-->

1. 调整[SpawnResources](../接口/世界/实体管理.md#spawnresources)(服务端)， 新增是否生成经验球参数，默认为False，设成True时按原版采集逻辑进行经验球掉落，如矿石类方块会产生随机数量的经验球<!--by xgb-->

1. 调整[GetItemBasicInfo](../接口/物品.md#getitembasicinfo)(服务端)， 新增字段，enchant_slot_type<!--by qiuyukun-->

1. 调整[GetActorRenderParams](../接口/实体/渲染.md#getactorrenderparams)(客户端)， 修复返回数据<!--by lrz-->

1. 调整[LockCamera](../接口/玩家/摄像机.md#lockcamera)(客户端)， lockRot支持roll旋转<!--by qiuyukun-->

1. 调整[AddCameraTrackMotion](../接口/玩家/摄像机.md#addcameratrackmotion)(客户端)， targetRot和startRot支持roll旋转<!--by qiuyukun-->

1. 调整[GetItemBasicInfo](../接口/物品.md#getitembasicinfo)(客户端)， 新增字段，enchant_slot_type<!--by qiuyukun-->

1. 调整[ServerBlockUseEvent](../事件/方块.md#serverblockuseevent)(服务端)， 客户端对应事件ClientBlockUseEvent如果开启拦截开关，则服务端也不会收到对应事件，即ServerBlockUseEvent不会触发。<!--by bl-->

1. 调整[ServerItemTryUseEvent](../事件/物品.md#serveritemtryuseevent)(服务端)， ClientItemTryUseEvent的cancel设置为True时，服务端事件不会被触发了。<!--by bl-->

1. 调整[ServerItemUseOnEvent](../事件/物品.md#serveritemuseonevent)(服务端)， 客户端事件ClientItemUseOnEvent设置ret设置为True时，服务端不再会接受到这个事件。<!--by bl-->

1. 调整[BlockStrengthChangedServerEvent](../事件/方块.md#blockstrengthchangedserverevent)(服务端)， 新增变化前的红石信号量参数<!--by qiuyukun-->

1. 调整[ClientItemTryUseEvent](../事件/物品.md#clientitemtryuseevent)(客户端)， ClientItemTryUseEvent事件设置cancel为True时,不会再给服务端同步物品使用网络包。<!--by bl-->

1. 调整[ClientItemUseOnEvent](../事件/物品.md#clientitemuseonevent)(客户端)， ClientItemUseOnEvent事件设置ret为True时，不会再给服务端同步物品使用网络包。<!--by bl-->

1. 调整[ClientBlockUseEvent](../事件/方块.md#clientblockuseevent)(客户端)， 当拦截交互逻辑时，不再会给服务端发送网络包，<!--by bl-->

1. 调整[BlockAnimateRandomTickEvent](../事件/方块.md#blockanimaterandomtickevent)(客户端)， 新增blockName与auxData参数<!--by xgb-->

1. 调整[ActorDamageCause](../枚举值/ActorDamageCause.md)， 微软把suicide改成了self_destruct<!--by xgb-->

1. 调整[OriginGUIName](../枚举值/OriginGUIName.md)， 增加摄像机视角按钮<!--by qiuyukun-->