3.0

2024.08.15：版本号（V3.0 BE1.20.11）

包括Mod PC包，手机测试版启动器，和服务器引擎。

示例Demo：前往此处下载

一、更新时间表

1. 在2024年8月15日上线3.0第一个Beta版。
2. 在2024年8月29日上线3.0第二个Beta版。
3. 在2024年9月12日上线3.0稳定版。
4. 在2024年9月20日，全渠道将更新3.0版本玩家包体，玩家将陆续更新到3.0版本，请开发者合理安排更新节奏。

二、重要功能更新

1. 支持获取实体的NBT标签，现在可以直接访问游戏中实体的NBT字典，并直接生成带有NBT标签的实体。详见GetEntityNBTTags和CreateEngineEntityByNBT接口。示例Demo与内容库也新增了对应的Demo：自定义精灵蛋。

   

2. 现在可以动态设置一个坐标或一片方块区域的群系，可用于改变群系效果，生物刷新规则等，详见SetBiomeByPos、SetBiomeByPosList、SetBiomeByVolume等接口。

   

3. 使用GetBonePositionFromMinecraftObject接口，您可以直接获取原版模型的骨骼世界坐标。有效增强物理交互与表现，进一步提高开发上限。

4. 利用SetBiomeInfo与GetBiomeInfo，现在可以动态改变群系的气候，决定是否降雪或者降雨。

5. 自定义物品新增 堆肥组件 。

6. 自定义方块 挖掘组件 新增锄速度加成属性。

三、API更新

• 新增

1. 新增IsTouchWithMouse(客户端)， 获取是否正在使用鼠标点击模拟触屏

2. 新增CreateEngineEntityByNBT(服务端)， 根据nbt数据创建实体

3. 新增SetBiomeInfo(服务端)， 设置群系天气相关参数,受引擎限制,目前snowAccumulation参数没有效果,downfall目前只影响湿度

4. 新增GetBiomeInfo(服务端)， 获取群系天气相关参数

5. 新增SetBiomeByPos(服务端)， 增加设置生物群系接口

6. 新增SetBiomeByPosList(服务端)， 增加设置生物群系接口

7. 新增SetBiomeByVolume(服务端)， 增加设置生物群系接口

8. 新增GetEntityNBTTags(服务端)， 获取实体的NBT标签

9. 新增PlayCustomUIMusic(客户端)， 播放UI音效，包括原版音效及自定义音效

10. 新增SetBlockRenderDistance(客户端)， 设置玩家周围区块的可渲染距离，无法超过视频设置中的能见度限制

11. 新增GetBlockRenderDistance(客户端)， 获取玩家周围的可渲染距离

12. 新增GetBonePositionFromMinecraftObject(客户端)， 获取原版模型的骨骼世界坐标

• 调整

1. 调整SetAttrValue(服务端)， 新增对AttrType.ARMOR的支持

2. 调整AddBlockItemListenForUseEvent(服务端)， auxvalue默认值从0改为*

3. 调整RemoveBlockItemListenForUseEvent(服务端)， auxvalue默认值从0改为*

4. 调整SetMobStrengthMax(服务端)， 增加的接口特殊情况说明：由于引擎限制，在羊驼被打时候会reload组件，strengthMax会恢复成llama.json中的配置值(minecraft:strength)

5. 调整LocateStructureFeature(服务端)， 支持只在未生成的区块中查找

6. 调整LocateNeteaseFeatureRule(服务端)， 支持获取未生成区块的地物结构

7. 调整SetPlayerGameType(服务端)， 新增对旁观模式的支持

8. 调整ChangeArmorTextures(客户端)， 修复uiIconTexture不支持None和""的问题

9. 调整SetEntityRenderDistance(客户端)， 实现调整为不影响方块的渲染距离

10. 调整AddBlockItemListenForUseEvent(客户端)， auxvalue默认值从0改为*

11. 调整RemoveBlockItemListenForUseEvent(客户端)， auxvalue默认值从0改为*

12. 调整SetCameraAnchor(客户端)， 修复交互中心第一人称下没有跟随偏移的BUG

13. 调整BindModelToEntity(客户端)， 新增scale参数控制挂接的模型缩放

14. 调整PlayerAttackEntityEvent(服务端)， 新增isCrit参数,用于判断本次攻击是否产生暴击

15. 调整DestroyBlockEvent(服务端)， 新增掉落物实体id列表

16. 调整PlayerFeedEntityServerEvent(服务端)， 调整备注，新增使用时注意事项

17. 调整EntityDieLoottableServerEvent(服务端)， 支持修改itemDict中的userData,userData必须为NBT数据格式,格式可参考NBT数据格式

• 修复

1. 修复SetMobStrength(服务端)， 修复当羊驼被打时候，强度值恢复。修复强度值没有存档。