13 KiB
2.7
2023.05.26：版本号（V2.7 BE1.18.30） 包括Mod PC包，手机测试版启动器，和服务器引擎。
示例Demo： 点击此处下载
一、更新时间表
- 在5月26日上线2.7第一个Beta版。
- 在6月09日上线2.7第二个Beta版。
- 在6月21日上线2.7稳定版。
- 在6月28日，全渠道将更新2.7版本玩家包体，玩家将陆续更新到2.7版本，请开发者合理安排更新节奏。
二、重要功能更新
支持UI设置到世界坐标
在CreateUI接口的参数中新增了绑定到世界坐标的参数，支持设置UI到指定坐标，详情参考CreateUI接口。
支持渲染指定掉落物
新增AddDropItemToWorld接口，将指定掉落物添加到指定坐标，详情参考AddDropItemToWorld接口。
自定义大型特征
新增拼图方块、自定义大型特征和结构池的数据驱动json，用于实现跨多个区块的大型随机特征（如原版村庄）效果，详情参考这篇文档。
中国版粒子支持拖尾渲染器
中国版粒子新增拖尾渲染模块，实现条带拖尾特效，详情请参考中国版粒子特效说明文档
UI新增轮盘控件
UI新增了一种轮盘控件，可用于自定义轮盘菜单，详情请参考轮盘控件说明文档。
自定义箱子
方块配置新增自定义箱子组件，可使方块具有箱子的储物功能，支持自定义容量，方块Json组件文档。
自定义树叶
新增了netease:no_crop_face_block组件，使其在相邻面渲染一个面，实现原版树叶方块的效果,详情请参考方块Json组件文档。
自定义工作台
新增了自定义工作台组件，可让方块具有工作台的特性，支持自定义该工作台的专属配方，详情参考自定义工作台。
自定义随机偏移方块
新增随机偏移组件netease:block_random_offset，使方块放置时可自定义随机偏移范围，详情参考方块Json组件文档。
其他
-
相机支持设置翻滚角，详见SetCameraRot。
-
与自定义物品类似，自定义方块也支持customtips组件了，详见方块Json组件文档。
-
自定义属性接口现在支持存档了，详见SetAttr接口。
-
新增了官方聊天扩展的5个功能接口，用于开发者定制聊天功能，详见RegisterChatPrefix。
温馨提示：上述聊天扩展接口仅在全渠道上线后方能生效！
重要修复
- 当使用物品信息字典时，如果enchantData里的附魔等级超过该附魔的最高等级，将会导致对该物品的生成（如SpawnItemToPlayerInv）和设置（如SetEntityItem）等接口失败。
在此版本之前，会生成一个无附魔的物品。
三、API更新
- 新增
-
新增GetLocalPosFromWorld(服务端)， 获取基于实体的世界坐标对应的局部坐标
-
新增GetWorldPosFromLocal(服务端)， 获取基于实体的局部坐标对应的世界坐标
-
新增GetLocalPosFromWorld(客户端)， 获取基于实体的世界坐标对应的局部坐标
-
新增GetWorldPosFromLocal(客户端)， 获取基于实体的局部坐标对应的世界坐标
-
新增GetPlayerList(客户端)， 客户端获取level中所有玩家的id列表
-
新增GetEngineActor(客户端)， 客户端获取所有实体（不包含玩家）。
-
新增SetPlayerMotion(服务端)， 设置玩家瞬时移动方向向量
-
新增SetJigsawBlock(服务端)， 在某一位置放置拼图方块
-
新增RegisterChatPrefix(服务端)， 官方聊天拓展功能 为游戏内指定玩家注册聊天前缀
-
新增SetShowSocialNearbyInfo(服务端)， 官方聊天扩展功能 是否显示社交界面同一游戏的附近信息
-
新增AddCommonPhrases(服务端)， 官方聊天扩展功能 新增常用聊天短语
-
新增RemoveCommonPhrases(服务端)， 官方聊天扩展功能 移除常用聊天短语
-
新增SetShowOfficialPhrases(服务端)， 官方聊天扩展功能 是否显示官方的常用聊天短语
-
新增HasComponent(服务端)， 判断实体是否有对应的原版组件
-
新增GetAllComponentsName(服务端)， 获取实体所拥有的原版组件list
-
新增GetStructureSize(服务端)， 获取结构体的长宽高
-
新增PlaceNeteaseLargeFeature(服务端)， 放置网易版大型结构特征
-
新增GetAttackTarget(客户端)， 客户端获取仇恨目标
-
新增CopyActorRenderMaterialFromPlayer(客户端)， 将渲染材质从某个玩家拷贝到某个生物identifier上
-
新增CopyActorGeometryFromPlayer(客户端)， 将渲染几何体从某个玩家拷贝到某个生物identifier上
-
新增CopyActorTextureFromPlayer(客户端)， 将贴图从某个玩家拷贝到某个生物identifier上
-
新增GetActorRenderParams(客户端)， 获取实体渲染参数
-
新增GetBiomeName(客户端)， 获取客户端当前维度已加载区域某一位置所属的生物群系信息
-
新增GetBlockEntityData(客户端)， 客户端获取方块（包括自定义方块）的数据
-
新增GetSize(客户端)， 客户端获取实体的包围盒
-
新增GetEntitiesAround(客户端)， 客户端获取区域内的entity列表
-
新增GetEntitiesInSquareArea(客户端)， 客户端获取区域内的entity列表
-
新增GetEntitiesAroundByType(客户端)， 客户端获取区域内的某类型的entity列表
-
新增AddDropItemToWorld(客户端)， 添加一个客户端掉落物渲染
-
新增GetClientDropItemEntityIdList(客户端)， 获得所有通过AddDropItemToWorld创建的entityId的list
-
新增DeleteClientDropItemEntity(客户端)， 删除AddDropItemToWorld创建的客户端掉落物
-
新增GetPlayerItem(客户端)， 客户端获取玩家物品，支持获取盔甲栏，副手以及主手物品
-
新增GetPlayerAllItems(客户端)， 客户端获取指定槽位的批量物品信息
-
新增GetName(客户端)， 客户端获取生物的自定义名称
-
新增GetPlayerHunger(客户端)， 客户端获取玩家饥饿度
-
新增GetEntityRider(客户端)， 客户端获取骑乘者正在骑乘的实体的id。
-
新增GetOwnerId(客户端)， 客户端获取驯服生物的主人id
-
新增GetTime(客户端)， 客户端获取当前世界时间
-
新增GetBindWorldPosition(客户端)， 取该UI绑定的worldPosition
-
新增asSelectionWheel(客户端)， 将当前BaseUIControl转换为SelectionWheelUIControl实例
-
新增SetIsSwallow(客户端)， 设置当前面板输入是否会吞噬事件
-
新增GetIsSwallow(客户端)， 判断当前面板输入是否会吞噬事件
-
新增GetSliceCount(客户端)， 获取轮盘可以选择的总切片数量
-
新增GetCurrentSliceIndex(客户端)， 获取轮盘当前选择的切片的index
-
新增SetCurrentSliceIndex(客户端)， 设置轮盘选择的切片
-
新增SetTouchUpCallback(客户端)， 设置轮盘选择切片并且鼠标按下抬起后触发回调函数
-
新增SetHoverCallback(客户端)， 设置轮盘选择切片触发回调函数
-
新增EntityComponentType， 原版实体组件类型
- 调整
-
调整CreateUI(客户端)， 添加了bindWorldPosition参数用于绑定世界坐标
-
调整LobbyGetAchievementStorage(服务端)， 支持在网络服使用
-
调整LobbySetAchievementStorage(服务端)， 支持在网络服使用
-
调整SpawnItemToPlayerInv(服务端)， 当附魔信息错误时，无法生成物品，返回False。调整前为会生成一个没有附魔的物品
-
调整SetPlayerAllItems(服务端)， 当附魔信息错误时，无法生成物品，返回False。调整前为会生成一个没有附魔的物品
-
调整SetAttr(服务端)， 新增needRestore参数用于自动存档并在实体加载时恢复
-
调整SetCameraRot(客户端)， 支持设置Roll（翻滚角）的角度