# 2.7

2023.05.26：版本号（V2.7 BE1.18.30）包括Mod PC包，手机测试版启动器，和服务器引擎。

示例Demo：点击此处下载 (opens new window)

# 一、更新时间表

在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（翻滚角）的角度

← 2.8 2.6 →