# 3.3

2025.3.21：版本号（V3.3 BE1.20.50）包括Mod PC包，手机测试版启动器，和服务器引擎。

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

## 一、更新时间表

1. 在2025年3月14日上线3.3第一个Beta版。
2. 在2025年3月21日上线3.3第二个Beta版。
3. 在2025年3月28日上线3.3稳定版。
4. 在2025年4月3日，全渠道将更新3.3版本玩家包体，玩家将陆续更新到3.3版本，请开发者合理安排更新节奏。

## 二、重要功能更新

1. 新增三类微软模型内置材质：**描边**、**金属光泽**、**忽略光照**，开发者可通过简单的参数配置实现高级渲染效果，详见<a href="../../../mcguide/16-美术/7-材质与着色器/2-内置材质清单.html#原版实体附加材质" rel="noopenner">原版实体附加材质</a>。

![描边效果](../picture/netease_outline.png)

2. <a href="../../../mcguide/20-玩法开发/15-自定义游戏内容/9-自定义指令.html" rel="noopenner">自定义指令</a>现支持参数变体配置，可在不开启作弊的情况下使用指令，并新增了一些参数类型。

![自定义指令](../picture/custom_command.png)

3. 支持播放方块/物品破坏粒子，以及物品被食用时的粒子，可用于增强游戏表现效果，实现加工、锻造等场景的完整视觉反馈链条。例如：机械动力中在传送带上压铸道具，农夫乐事砧板切碎食材等。
4. 我们重新设计了底层数据协议，原生支持Python基础数据类型的直接存储和传输，包括long、tuple、set和frozenset，便于开发者存储和传输复杂数据结构（如方块调色板）。涉及接口包括SetConfigData、GetConfigData、Mod SDK双端通信接口、Apollo通信接口等。**请不要在3.3存储含有tuple等数据后，在3.2旧版读取并再次存储，将导致数据格式错误**。
5. 新增物品组件<a href="../../../mcguide/20-玩法开发/15-自定义游戏内容/1-自定义物品/1-自定义基础物品.html#netease-initial-user-data" rel="noopenner">netease:initial_user_data</a>，用于指定在创造物品栏中注册的初始NBT数据，简化如自带附魔的物品或特殊属性道具的注册流程。
6. 新增方块组件<a href="../../../mcguide/20-玩法开发/15-自定义游戏内容/2-自定义方块/1-JSON组件.html#netease-block-animate-random-tick" rel="noopenner">netease:block_animate_random_tick</a>，该组件可方便地实现如落叶飘落、粒子飞散等效果，并对性能无明显影响。
7. 新增维度组件<a href="../../../mcguide/20-玩法开发/15-自定义游戏内容/4-自定义维度/1-自定义维度.html#维度配置" rel="noopenner">netease:ban_vanilla_structure</a>，用于灵活地屏蔽原版结构生成。
8. 新增获取游戏版本号的接口，便于开发者提前向未来版本兼容。
9. 新增获取/设置剪贴板内容的接口，便于外部软件与游戏内组件交互。
10. [ServerEntityTryPlaceBlockEvent](../事件/方块.md#serverentitytryplaceblockevent)新增点击位置参数，支持修改位置和方块数据，开发者可通过事件参数动态调整方块属性和坐标，实现更精准的方块放置逻辑，便于制作自定义半砖、楼梯等方块。
11. 所有[伤害事件](../事件/实体.md#actuallyhurtserverevent)参数统一为float类型，并优化计算管线。请开发者注意“补偿伤害”的处理，避免将其视为真正伤害。
12. 支持纯客户端实体，允许在客户端根据资源包定义直接显示实体模型，无需对应的服务端实体。
13. 更新<a href="../../../mcguide/18-界面与交互/30-UI说明文档.html" rel="noopenner">UI说明文档</a>、<a href="../../../mcguide/18-界面与交互/70-UI数据绑定.html" rel="noopenner">UI数据绑定</a>、<a href="../../../mcguide/20-玩法开发/15-自定义游戏内容/5-自定义配方.html" rel="noopenner">自定义配方</a>、<a href="../../../mcguide/30-测试/5-性能监测与调试工具.html" rel="noopenner">性能监测与调试</a>、<a href="../../../mcguide/36-审核与下架/课程03-机器审核流程及指标介绍.html" rel="noopenner">机器审核流程及指标介绍</a>、<a href="../../../mcguide/20-玩法开发/18-性能优化/代码优化.html#优化字节码" rel="noopenner">优化字节码</a>等文档，后续将持续更新更多教程，敬请期待。
14. 为便于开发者搜索接口，<a href="../../../mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/更新信息/2.4.0.html" rel="noopenner">Preset API</a>已移动至开发指南中。

## 三、API更新

- 新增

1. 新增[GetMinecraftVersion](../接口/通用/本地设备.md#getminecraftversion)(服务端)， 获取Minecraft版本号<!--by czk-->

1. 新增[GetEngineVersion](../接口/通用/本地设备.md#getengineversion)(客户端)， 获取引擎版本号<!--by czk-->

1. 新增[GetMinecraftVersion](../接口/通用/本地设备.md#getminecraftversion)(客户端)， 获取Minecraft版本号<!--by czk-->

1. 新增[CreateClientEntityByTypeStr](../接口/世界/实体管理.md#createcliententitybytypestr)(客户端)， 创建客户端实体,仅用于渲染<!--by qyk-->

1. 新增[DestroyClientEntity](../接口/世界/实体管理.md#destroycliententity)(客户端)， 销毁客户端实体<!--by qyk-->

1. 新增[GetLoadEffects](../接口/实体/状态效果.md#getloadeffects)(服务端)， 获取所有已加载的状态效果<!--by chenyuekai-->

1. 新增[AddTerrainDestroyParticleEffect](../接口/世界/渲染.md#addterraindestroyparticleeffect)(客户端)， 在指定位置播放指定方块被开始破坏时的粒子效果<!--by xujiarong02-->

1. 新增[RemoveTerrainDestroyParticleEffect](../接口/世界/渲染.md#removeterraindestroyparticleeffect)(客户端)， 停止指定位置播放的方块被开始破坏时的粒子效果<!--by xujiarong02-->

1. 新增[GetLocalTime](../接口/世界/时间.md#getlocaltime)(客户端)， 获取当前维度的时间<!--by lrz-->

1. 新增[SetClipboardContent](../接口/通用/工具.md#setclipboardcontent)(客户端)， 设置系统剪贴板内容<!--by xujiarong02-->

1. 新增[GetClipboardContent](../接口/通用/工具.md#getclipboardcontent)(客户端)， 获取系统剪贴板内容<!--by xujiarong02-->

1. 新增[AddUseItemParticleEffect](../接口/世界/渲染.md#adduseitemparticleeffect)(客户端)， 在指定位置播放指定物品被开始使用时的粒子效果<!--by xujiarong02-->

1. 新增[RemoveUseItemParticleEffect](../接口/世界/渲染.md#removeuseitemparticleeffect)(客户端)， 停止指定位置播放的物品被开始使用时的粒子效果<!--by xujiarong02-->

1. 新增[IsOnLadder](../接口/玩家/行为.md#isonladder)(客户端)， 获取玩家是否在梯子/藤蔓上<!--by lrz-->

1. 新增[IsInScaffolding](../接口/玩家/行为.md#isinscaffolding)(客户端)， 获取玩家是否在脚手架中<!--by lrz-->

1. 新增[CustomCommandTriggerServerEvent](../事件/世界.md#customcommandtriggerserverevent)(服务端)， 新增参数变体返回参数<!--by chenyuekai-->

1. 新增[MountTamingEvent](../事件/玩家.md#mounttamingevent)(服务端)， 玩家通过骑乘驯服生物事件<!--by lrz-->

1. 新增[PlayerAttackEntityEvent](../事件/玩家.md#playerattackentityevent)(客户端)， 客户端新增玩家攻击实体事件，只有本地玩家会触发<!--by xgb-->

1. 新增[BlockAnimateRandomTickEvent](../事件/方块.md#blockanimaterandomtickevent)(客户端)， 客户端新增类似樱花树叶/末地烛的随机动效Tick事件<!--by xgb-->

1. 新增[HudButtonChangedClientEvent](../事件/UI.md#hudbuttonchangedclientevent)(客户端)， 当原生HUD按钮位置或大小改变时触发<!--by lidi-->

- 调整

1. 调整[SetHurtByEntity](../)(服务端)， damage改为浮点型<!--by xgb-->

1. 调整[Hurt](../接口/实体/行为.md#hurt)(服务端)， damage改为浮点型<!--by xgb-->

1. 调整[GetItemInfoByBlockName](../接口/物品.md#getiteminfobyblockname)(服务端)， 新增isLegacy参数，默认为True<!--by liruizhi-->

1. 调整[SetDeviceVibrate](../接口/控制.md#setdevicevibrate)(客户端)， 支持iOS震动，取消内置cd及震动时长上限<!--by lidi-->

1. 调整[Bind](../接口/特效/粒子.md#bind)(客户端)， 新增是否是纯客户端实体参数<!--by qyk-->

1. 调整[DamageEvent](../事件/实体.md#damageevent)(服务端)， damage改为浮点型，damage_f字段在未来的版本将会移除<!--by xgb-->

1. 调整[ActuallyHurtServerEvent](../事件/实体.md#actuallyhurtserverevent)(服务端)， damage改为浮点型，damage_f字段在未来的版本将会移除，新增invulnerableTime与lastHurt参数<!--by xgb-->

1. 调整[PlayerAttackEntityEvent](../事件/玩家.md#playerattackentityevent)(服务端)， damage支持浮点型<!--by xgb-->

1. 调整[ServerEntityTryPlaceBlockEvent](../事件/方块.md#serverentitytryplaceblockevent)(服务端)， 添加可以修改放置方块信息的逻辑，添加clickX，clickY，clickZ参数<!--by chenyuekai-->

1. 调整[AddEffectServerEvent](../事件/实体.md#addeffectserverevent)(服务端)， damage改为浮点型<!--by xgb-->

1. 调整[WillAddEffectServerEvent](../事件/实体.md#willaddeffectserverevent)(服务端)， damage改为浮点型<!--by xgb-->

1. 调整[RefreshEffectServerEvent](../事件/实体.md#refresheffectserverevent)(服务端)， damage改为浮点型<!--by xgb-->

1. 调整[ActorHurtServerEvent](../事件/实体.md#actorhurtserverevent)(服务端)， damage改为浮点型<!--by xgb-->

1. 调整[EntityEffectDamageServerEvent](../事件/实体.md#entityeffectdamageserverevent)(服务端)， damage改为浮点型<!--by xgb-->

1. 调整[BlockDestroyByLiquidServerEvent](../事件/方块.md#blockdestroybyliquidserverevent)(服务端)， 添加维度信息<!--by czk-->

1. 调整[OptionId](../枚举值/OptionId.md)， 新增强制疾跑OptionId<!--by lidi-->

1. 调整[OriginGUIName](../枚举值/OriginGUIName.md)， 增加新触控破坏/攻击按钮、建造/交互按钮、新触控摇杆按钮<!--by lidi-->

- 废弃（将在未来不可用）

1. 废弃SpawnItemToLevel，请使用CreateEngineItemEntity