# 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标签的实体。详见GetEntityNBTTagsCreateEngineEntityByNBT接口。示例Demo与内容库也新增了对应的Demo:自定义精灵蛋。

    v30_nbt

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

    V30_setbiome

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

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

  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(服务端), 修复当羊驼被打时候,强度值恢复。修复强度值没有存档。

一、更新时间表

二、重要功能更新

三、API更新