# 3.3

2025.3.14:版本号(V3.3 BE1.20.50)包括Mod PC包,手机测试版启动器,和服务器引擎。

示例Demo:前往此处下载

# 一、更新时间表

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

# 二、重要功能更新

  1. 新增三类微软模型内置材质:描边金属光泽忽略光照,开发者可通过简单的参数配置实现高级渲染效果,详见原版实体附加材质

描边效果

  1. 自定义指令现支持参数变体配置,可在不开启作弊的情况下使用指令,并新增了一些参数类型。

自定义指令

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

# 三、API更新

  • 新增
  1. 新增GetMinecraftVersion(服务端), 获取Minecraft版本号

  2. 新增GetEngineVersion(客户端), 获取引擎版本号

  3. 新增GetMinecraftVersion(客户端), 获取Minecraft版本号

  4. 新增CreateClientEntityByTypeStr(客户端), 创建客户端实体,仅用于渲染

  5. 新增DestroyClientEntity(客户端), 销毁客户端实体

  6. 新增GetLoadEffects(服务端), 获取所有已加载的状态效果

  7. 新增AddTerrainDestroyParticleEffect(客户端), 在指定位置播放指定方块被开始破坏时的粒子效果

  8. 新增RemoveTerrainDestroyParticleEffect(客户端), 停止指定位置播放的方块被开始破坏时的粒子效果

  9. 新增GetLocalTime(客户端), 获取当前维度的时间

  10. 新增SetClipboardContent(客户端), 设置系统剪贴板内容

  11. 新增GetClipboardContent(客户端), 获取系统剪贴板内容

  12. 新增AddUseItemParticleEffect(客户端), 在指定位置播放指定物品被开始使用时的粒子效果

  13. 新增RemoveUseItemParticleEffect(客户端), 停止指定位置播放的物品被开始使用时的粒子效果

  14. 新增IsOnLadder(客户端), 获取玩家是否在梯子/藤蔓上

  15. 新增IsInScaffolding(客户端), 获取玩家是否在脚手架中

  16. 新增CustomCommandTriggerServerEvent(服务端), 新增参数变体返回参数

  17. 新增MountTamingEvent(服务端), 玩家通过骑乘驯服生物事件

  18. 新增PlayerAttackEntityEvent(客户端), 客户端新增玩家攻击实体事件,只有本地玩家会触发

  19. 新增BlockAnimateRandomTickEvent(客户端), 客户端新增类似樱花树叶/末地烛的随机动效Tick事件

  20. 新增HudButtonChangedClientEvent(客户端), 当原生HUD按钮位置或大小改变时触发

  • 调整
  1. 调整Hurt(服务端), damage改为浮点型

  2. 调整GetItemInfoByBlockName(服务端), 新增isLegacy参数,默认为True

  3. 调整SetDeviceVibrate(客户端), 支持iOS震动,取消内置cd及震动时长上限

  4. 调整Bind(客户端), 新增是否是纯客户端实体参数

  5. 调整DamageEvent(服务端), damage改为浮点型,damage_f字段在未来的版本将会移除

  6. 调整ActuallyHurtServerEvent(服务端), damage改为浮点型,damage_f字段在未来的版本将会移除,新增invulnerableTime与lastHurt参数

  7. 调整PlayerAttackEntityEvent(服务端), damage支持浮点型

  8. 调整ServerEntityTryPlaceBlockEvent(服务端), 添加可以修改放置方块信息的逻辑,添加clickX,clickY,clickZ参数

  9. 调整AddEffectServerEvent(服务端), damage改为浮点型

  10. 调整WillAddEffectServerEvent(服务端), damage改为浮点型

  11. 调整RefreshEffectServerEvent(服务端), damage改为浮点型

  12. 调整ActorHurtServerEvent(服务端), damage改为浮点型

  13. 调整EntityEffectDamageServerEvent(服务端), damage改为浮点型

  14. 调整BlockDestroyByLiquidServerEvent(服务端), 添加维度信息

  15. 调整OptionId, 新增强制疾跑OptionId

  16. 调整OriginGUIName, 增加新触控破坏/攻击按钮、建造/交互按钮、新触控摇杆按钮

  • 废弃(将在未来不可用)
  1. 废弃SpawnItemToLevel,请使用CreateEngineItemEntity