# 2.3

2022.8.23：版本号（v2.3 BE1.18.0）

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

- 温馨提示

在8月23日，上线2.3第一个beta版。

在9月6日，上线2.3第二个beta版。

在9月15日，上线2.3的稳定版。

在9月23日，全渠道将更新2.3版本玩家包体，玩家将陆续更新到2.3版本，请开发者合理安排更新节奏。

下载[2.3 Demo](https://g79.gdl.netease.com/2.3DemoV2.zip)。

## 新增重大功能介绍

### 1. 自定义地形高度

新增了2种高度控制节点，开发者可将其配置在群系配置文件中，灵活控制指定群系下不同位置地形的高度。
例如下图就是使用新版的填充节点实现的效果。
详情参考<a href="../../../mcguide/20-玩法开发/15-自定义游戏内容/4-自定义维度/2-群系地貌.html#5.自定义群系高度（网易版）">这篇文档</a>。

![自定义地形高度1](../picture/zdydxgd1.png)


### 2. 支持骨骼模型挂接微软粒子

详情请见[微软粒子接口](../接口/特效/微软粒子.md#bindmodel)

![微软粒子1](../picture/skeleton_model_with_particle.gif)

### 3. colormap支持对方块指定面生效

详情参考<a href="../../../mcguide/20-玩法开发/15-自定义游戏内容/2-自定义方块/2-功能.html#自定义方块及自定义方块模型的群系颜色">这篇文档</a>。

![corlormap](../picture/colormap.png)

### 4. 实体支持接口设置网格体和贴图

详情见[实体接口](../接口/实体/渲染.md#AddActorGeometry)

![实体设置网格体](../picture/entitysetgeo.png)



## API改动
 
### 新增

1. 新增[PlayHudHeartBlinkAnim](../接口/原生UI.md#playhudheartblinkanim)(客户端)， 播放原版受伤时血量变化的动画<!--by wangjian18-->

2. 新增[SetPlayerUIItem](../接口/方块/容器.md#setplayeruiitem)(服务端)， 设置合成容器的物品<!--by wangdingdong-->

3. 新增[AddActorGeometry](../接口/实体/渲染.md#addactorgeometry)(客户端)， 增加生物渲染几何体<!--by wangdingdong-->

4. 新增[RemoveActorGeometry](../接口/实体/渲染.md#removeactorgeometry)(客户端)， 删除生物渲染几何体<!--by wangdingdong-->

5. 新增[AddActorTexture](../接口/实体/渲染.md#addactortexture)(客户端)， 增加生物渲染贴图<!--by wangdingdong-->

6. 新增[RemoveActorTexture](../接口/实体/渲染.md#removeactortexture)(客户端)， 删除生物渲染贴图<!--by wangdingdong-->

7. 新增[SetPlayerItemInHandVisible](../接口/玩家/渲染.md#setplayeriteminhandvisible)(客户端)， 设置是否隐藏玩家的手持物品模型显示<!--by xujiarong02-->

8. 新增[GetBlockTextures](../接口/方块/渲染.md#getblocktextures)(客户端)， 获取方块的初始贴图信息<!--by wangdingdong-->

9. 新增[SetEmoteSwitch](../接口/原生UI.md#setemoteswitch)(客户端)， 设置表情开关<!--by huangxiaojie03-->

10. 新增[BindModel](../接口/特效/微软粒子.md#bindmodel)(客户端)， 绑定粒子发射器到骨骼模型上<!--by wangdingdong-->

11. 新增[GetBindingModleID](../接口/特效/微软粒子.md#getbindingmodleid)(客户端)， 获取粒子发射器绑定的骨骼模型id<!--by wangdingdong-->

12. 新增[AchievementCompleteEvent](../事件/世界.md#achievementcompleteevent)(服务端)， 玩家完成自定义成就的事件<!--by cxz-->

13. 新增[AddPlayerCreatedClientEvent](../事件/世界.md#addplayercreatedclientevent)(客户端)， 增加客户端其他玩家进入区块AOI后资源加载完成的事件<!--by wdd-->

### 调整

1. 调整[GetPlayerList](../接口/世界/实体管理.md#getplayerlist)(服务端)， 返回列表按照id进行排序<!--by wdd-->

2. 调整[SetAttrValue](../接口/实体/属性.md#setattrvalue)(服务端)， 设置值超过float表示范围时返回False<!--by wangdingdong-->

3. 调整[SetAttrMaxValue](../接口/实体/属性.md#setattrmaxvalue)(服务端)， 设置值超过float表示范围时返回False<!--by wangdingdong-->

4. 调整[RegisterBlockPatterns](../接口/世界/方块组合.md#registerblockpatterns)(服务端)， 已有相同pattern以及defines组合的合成时返回False<!--by wdd-->

5. 调整[SetBlockNew](../接口/世界/方块管理.md#setblocknew)(服务端)， 增加参数isLegacy，默认为False即使用最新版本的aux对应的state<!--by wdd-->

6. 调整[OnPlayerActiveShieldServerEvent](../事件/物品.md#onplayeractiveshieldserverevent)(服务端)， 在潜行状态切换盾牌也会触发该事件<!--by czh-->

7. 调整[StartRidingClientEvent](../事件/实体.md#startridingclientevent)(客户端)， 删除cancel参数，客户端触发事件时，玩家已经上马<!--by xusifan-->

### 废弃（将在未来不可用）

1. 废弃UnDefineEvent，监听自定义事件前不再需要DefineEvent，所以也不再需要使用UnDefineEvent