# 3.3
2025.3.14:版本号(V3.3 BE1.20.50)包括Mod PC包,手机测试版启动器,和服务器引擎。
示例Demo:前往此处下载
# 一、更新时间表
- 在2025年3月14日上线3.3第一个Beta版。
- 在2025年3月27日上线3.3第二个Beta版。
- 在2025年4月8日上线3.3稳定版。
- 在2025年4月11日,全渠道将更新3.3版本玩家包体,玩家将陆续更新到3.3版本,请开发者合理安排更新节奏。
# 二、重要功能更新
- 新增三类微软模型内置材质:描边、金属光泽、忽略光照,开发者可通过简单的参数配置实现高级渲染效果,详见原版实体附加材质。
- 自定义指令现支持参数变体配置,可在不开启作弊的情况下使用指令,并新增了一些参数类型。
- 支持播放方块/物品破坏粒子,以及物品被食用时的粒子,可用于增强游戏表现效果,实现加工、锻造等场景的完整视觉反馈链条。例如:机械动力中在传送带上压铸道具,农夫乐事砧板切碎食材等。
- 我们重新设计了底层数据协议,原生支持Python基础数据类型的直接存储和传输,包括long、tuple、set和frozenset,便于开发者存储和传输复杂数据结构(如方块调色板)。涉及接口包括SetConfigData、GetConfigData、Mod SDK双端通信接口、Apollo通信接口等。
- 新增物品组件netease:initial_user_data,用于指定在创造物品栏中注册的初始NBT数据,简化如自带附魔的物品或特殊属性道具的注册流程。
- 新增方块组件netease:block_animate_random_tick,该组件可方便地实现如落叶飘落、粒子飞散等效果,并对性能无明显影响。
- 新增维度组件netease:ban_vanilla_structure,用于灵活地屏蔽原版结构生成。
- 新增获取游戏版本号的接口,便于开发者提前向未来版本兼容。
- 新增获取/设置剪贴板内容的接口,便于外部软件与游戏内组件交互。
- 新增获取本地联机和联机大厅房主的接口,便于开发者进行权限管理。
- ServerEntityTryPlaceBlockEvent新增点击位置参数,支持修改位置和方块数据,开发者可通过事件参数动态调整方块属性和坐标,实现更精准的方块放置逻辑,便于制作自定义半砖、楼梯等方块。
- 所有伤害事件参数统一为float类型,并优化计算管线。请开发者注意“补偿伤害”的处理,避免将其视为真正伤害。
- 支持纯客户端实体,允许在客户端根据资源包定义直接显示实体模型,无需对应的服务端实体。
- 更新UI说明文档、UI数据绑定、自定义配方、性能监测与调试、机器审核流程及指标介绍、优化字节码等文档,后续将持续更新更多教程,敬请期待。
- 为便于开发者搜索接口,Preset API已移动至开发指南中。
# 三、API更新
- 新增
新增GetMinecraftVersion(服务端), 获取Minecraft版本号
新增GetEngineVersion(客户端), 获取引擎版本号
新增GetMinecraftVersion(客户端), 获取Minecraft版本号
新增CreateClientEntityByTypeStr(客户端), 创建客户端实体,仅用于渲染
新增DestroyClientEntity(客户端), 销毁客户端实体
新增GetLoadEffects(服务端), 获取所有已加载的状态效果
新增AddTerrainDestroyParticleEffect(客户端), 在指定位置播放指定方块被开始破坏时的粒子效果
新增RemoveTerrainDestroyParticleEffect(客户端), 停止指定位置播放的方块被开始破坏时的粒子效果
新增GetLocalTime(客户端), 获取当前维度的时间
新增SetClipboardContent(客户端), 设置系统剪贴板内容
新增GetClipboardContent(客户端), 获取系统剪贴板内容
新增AddUseItemParticleEffect(客户端), 在指定位置播放指定物品被开始使用时的粒子效果
新增RemoveUseItemParticleEffect(客户端), 停止指定位置播放的物品被开始使用时的粒子效果
新增IsOnLadder(客户端), 获取玩家是否在梯子/藤蔓上
新增IsInScaffolding(客户端), 获取玩家是否在脚手架中
新增CustomCommandTriggerServerEvent(服务端), 新增参数变体返回参数
新增MountTamingEvent(服务端), 玩家通过骑乘驯服生物事件
新增PlayerAttackEntityEvent(客户端), 客户端新增玩家攻击实体事件,只有本地玩家会触发
新增BlockAnimateRandomTickEvent(客户端), 客户端新增类似樱花树叶/末地烛的随机动效Tick事件
新增HudButtonChangedClientEvent(客户端), 当原生HUD按钮位置或大小改变时触发
- 调整
调整Hurt(服务端), damage改为浮点型
调整GetItemInfoByBlockName(服务端), 新增isLegacy参数,默认为True
调整SetDeviceVibrate(客户端), 支持iOS震动,取消内置cd及震动时长上限
调整Bind(客户端), 新增是否是纯客户端实体参数
调整DamageEvent(服务端), damage改为浮点型,damage_f字段在未来的版本将会移除
调整ActuallyHurtServerEvent(服务端), damage改为浮点型,damage_f字段在未来的版本将会移除,新增invulnerableTime与lastHurt参数
调整PlayerAttackEntityEvent(服务端), damage支持浮点型
调整ServerEntityTryPlaceBlockEvent(服务端), 添加可以修改放置方块信息的逻辑,添加clickX,clickY,clickZ参数
调整AddEffectServerEvent(服务端), damage改为浮点型
调整WillAddEffectServerEvent(服务端), damage改为浮点型
调整RefreshEffectServerEvent(服务端), damage改为浮点型
调整ActorHurtServerEvent(服务端), damage改为浮点型
调整EntityEffectDamageServerEvent(服务端), damage改为浮点型
调整BlockDestroyByLiquidServerEvent(服务端), 添加维度信息
调整OptionId, 新增强制疾跑OptionId
调整OriginGUIName, 增加新触控破坏/攻击按钮、建造/交互按钮、新触控摇杆按钮
- 废弃(将在未来不可用)
- 废弃SpawnItemToLevel,请使用CreateEngineItemEntity
← WalkState Apollo更新信息 →