1.21

2021.1.28：版本号（v1.21 BE1.16.10）

• 版本重大更新

  1. 小地图增加如下更新：

     1）优化地图渲染，避免在低端机下出现明显的卡顿；

     2）支持自定义大小，同时可通过接口SetSize动态改变大小；

     3）标记图标支持默认使用本地玩家的脸部显示，并可配置其大小与背景色，详见 MiniMap

     4）接口AddEntityMarker支持朝向标记；

     5）增加地图缩小放大功能，见接口ZoomIn和ZoomOut；

     6）静态标记默认保存到本地；

     7）小地图背景可在ui json中进行定制；

     8）更新了小地图示例 CustomMapMod

  2. 若干方块相关事件中的添加维度信息

  3. 物品贴图支持使用 序列帧动画

  4. 支持动态修改物品、盔甲和方块贴图，详见ChangeItemTexture、ChangeArmorTextures、ChangeBlockTextures

  5. 支持UI控件对象化开发，用法详见 UI控件对象

     1）实现控件基类BaseUIControl，包含控件的基础功能接口，详见BaseUIControl；

     2）实现按钮控件类，继承自BaseUIControl，除基础功能接口外包含按钮相关功能接口，详见ButtonUIControl；

     3）实现网格控件类，继承自BaseUIControl，除基础功能接口外包含网格相关功能接口，详见GridUIControl；

     4）实现图片控件类，继承自BaseUIControl，除基础功能接口外包含图片相关功能接口，详见ImageUIControl；

     5）实现文本控件类，继承自BaseUIControl，除基础功能接口外包含文本相关功能接口，详见LabelUIControl；

     6）实现纸娃娃控件类，继承自BaseUIControl，除基础功能接口外包含纸娃娃相关功能接口，详见NeteasePaperDollUIControl；

     7）实现进度条控件类，继承自BaseUIControl，除基础功能接口外包含进度条相关功能接口，详见ProgressBarUIControl；

     8）实现滚动列表控件类，继承自BaseUIControl，除基础功能接口外包含滚动列表相关功能接口，详见ScrollViewUIControl

     9）实现开关控件类，继承自BaseUIControl，除基础功能接口外包含开关相关功能接口，详见SwitchToggleUIControl

     10）实现文本输入框控件类，继承自BaseUIControl，除基础功能接口外包含文本输入框相关功能接口，详见TextEditBoxUIControl

• 新增

1. 新增IsInApollo，返回当前游戏Mod是否运行在Apollo网络服

2. 新增HideHorseHealthGui，隐藏hud界面的坐骑的血量显示

3. 新增SetStepHeight，设置玩家前进非跳跃状态下能上的最大台阶高度

4. 新增GetStepHeight，返回玩家前进非跳跃状态下能上的最大台阶高度

5. 新增ResetStepHeight，恢复引擎默认玩家前进非跳跃状态下能上的最大台阶高度，即恢复为原来的0.5625

6. 新增MayPlace，判断方块是否可以放置

7. 新增ListenOnBlockRemoveEvent，是否监听方块BlockRemoveServerEvent事件

8. 新增GetOrbExperience，获取经验球的经验

9. 新增GetPlayerTotalExp，获取玩家的总经验值

10. 新增SetPlayerTotalExp，设置玩家的总经验值

11. 新增GetSpawnPosition，获取世界出生点坐标

12. 新增Hurt，设置实体伤害

13. 新增GetBannedItemList，新增获取禁用物品列表

14. 新增SpawnItemToContainer，新增生成物品到容器

15. 新增SpawnItemToEnderChest，新增生成物品到末影箱

16. 新增GetContainerSize，新增获取容器容量大小

17. 新增MayPlaceOn，判断物品是否可以放到指定的位置上

18. 新增GetItemDurability，获取指定槽位的物品耐久

19. 新增SetItemDurability，设置物品的耐久值

20. 新增SetMaxStackSize，设置物品的最大堆叠数量（存档）

21. 新增SetAttackDamage，设置物品的攻击伤害值

22. 新增SetItemTierLevel，设置工具类物品的挖掘等级

23. 新增SetItemTierSpeed，设置工具类物品的挖掘速度

24. 新增ShowCommonHurtColor，设置挂接骨骼模型的实体是否显示通用的受伤变红效果

25. 新增SetPlayerRespawnPos，设置玩家复活的位置，当前玩家的复活点仅支持主世界

26. 新增ChangeArmorTextures，修改盔甲贴图

27. 新增ChangeBlockTextures，替换方块的贴图，使用该贴图的所有方块朝向或者使用该贴图的其它方块也会同时被改变

28. 新增GetConfigData，获取本地配置文件中存储的数据

29. 新增SetConfigData，以本地配置文件的方式存储数据

30. 新增GetCurrentDimension，获取客户端当前维度

31. 新增ChangeItemTexture，替换物品的贴图

32. 新增ShowCommonHurtColor，设置挂接骨骼模型的实体是否显示通用的受伤变红效果

33. 新增SetUIProfile，设置"UI 档案"模式

34. 新增SetToggleOption，修改开关型设置的接口

35. 新增GetToggleOption，获得某个开关设置值的接口

36. 新增HighlightBoxSelection，镜头移动时高亮当前视角中心所指的方块

37. 新增SetSelectControl，设置当前焦点所在的控件

38. 新增ZoomIn，放大地图

39. 新增ZoomOut，缩小地图

40. 新增ZoomReset，恢复地图放缩大小为默认值

41. 新增ServerEntityTryPlaceBlockEvent，新增维度id参数，新增朝向参数

42. 新增DestroyBlockEvent，新增维度id参数

43. 新增ServerPreBlockPatternEvent，新增维度id参数

44. 新增ServerBlockUseEvent，新增维度id参数

45. 新增StepOnBlockServerEvent，新增维度id参数

46. 新增MobGriefingBlockServerEvent，新增维度id参数

47. 新增ExplosionServerEvent，新增维度id参数

48. 新增PlayerRespawnFinishServerEvent，玩家复活完毕事件

49. 新增ServerPostBlockPatternEvent，新增维度id参数

50. 新增PlaceNeteaseStructureFeatureEvent，新增维度id参数

51. 新增OnPlayerHitBlockServerEvent，新增维度id以及auxValue参数

52. 新增EntityPlaceBlockAfterServerEvent，新增维度id参数

53. 新增HopperTryPullInServerEvent，新增维度id参数

54. 新增HopperTryPullOutServerEvent，新增维度id参数

55. 新增EntityEffectDamageServerEvent，生物受到状态伤害事件。

56. 新增OnCommandOutputServerEvent，Command命令执行成功事件。

57. 新增PlayerChatButtonClickClientEvent，玩家点击聊天按钮或回车键触发呼出聊天窗口时客户端抛出的事件

58. 新增PerspChangeClientEvent，视角切换事件

59. 新增ColorCode，代替GenerateColor接口

60. 新增UiBaseLayer，自定义UI界面的层次宏定义

• 调整

1. 调整SetEntityOnFire，调整说明，可通过事件OnFireHurtEvent取消着火伤害

2. 调整SpawnItemToArmor，支持清除指定槽位的装备

3. 调整GetItemBasicInfo，新增idAux字段，用于ui物品控件的绑定

4. 调整SetMoveSetting，现在支持游泳，爬墙与飞行生物

5. 调整GetRecipesByResult，返回的配方中将包含输出的物品

6. 调整AddPlayerRenderMaterial，修复从后台切回来被重置的问题

7. 调整AddPlayerRenderController，修复从后台切回来被重置的问题

8. 调整RemovePlayerRenderController，修复从后台切回来被重置的问题

9. 调整RemovePlayerGeometry，修复从后台切回来被重置的问题

10. 调整AddPlayerGeometry，修复从后台切回来被重置的问题

11. 调整AddPlayerTexture，修复从后台切回来被重置的问题

12. 调整AddPlayerAnimation，修复从后台切回来被重置的问题

13. 调整AddPlayerAnimationController，修复从后台切回来被重置的问题

14. 调整RemovePlayerAnimationController，修复从后台切回来被重置的问题

15. 调整RebuildPlayerRender，修复从后台切回来被重置的问题

16. 调整AddActorRenderMaterial，修复从后台切回来被重置的问题

17. 调整AddActorRenderController，修复从后台切回来被重置的问题

18. 调整RemoveActorRenderController，修复从后台切回来被重置的问题

19. 调整RebuildActorRender，修复从后台切回来被重置的问题

20. 调整GetItemBasicInfo，新增idAux字段，用于ui物品控件的绑定

21. 调整SetLegacyBindRot，为了适配studio，调整为骨骼模型创建时默认为False，不再需要设置。但是对于旧版特效，仍然可以设置为True来适配。

22. 调整SetUiItem，新增支持焰火之星

23. 调整AddEntityMarker，支持实体标记旋转角度

24. 调整AddStaticMarker，静态标记会保存在本地

25. 调整RemoveStaticMarker，删除静态标记会删除本地数据

26. 调整ServerPlayerTryDestroyBlockEvent，参数新增方块被敲击的面向id，维度id以及是否生成掉落物

27. 调整ChestBlockTryPairWithServerEvent，新增维度id参数

28. 调整OnFireHurtEvent，新增着火时间参数fireTime和取消伤害参数cancel

29. 调整ServerItemUseOnEvent，新增维度id，blockName，以及blockAuxValue参数

30. 调整ItemUseOnAfterServerEvent，新增维度id，blockName，以及blockAuxValue参数

31. 调整AddEffectServerEvent，新增伤害参数damage

32. 调整WillAddEffectServerEvent，新增伤害参数damage

33. 调整RefreshEffectServerEvent，新增伤害参数damage

34. 调整BlockStrengthChangedServerEvent，增加维度参数

35. 调整BlockRemoveServerEvent，可以动态对方块的该事件进行监听

36. 调整StartDestroyBlockServerEvent，新增维度id参数

37. 调整ClientItemUseOnEvent，新增blockName、blockAuxValue、face参数

38. 调整PlayerTryDestroyBlockClientEvent，参数新增方块被敲击的面向id

39. 调整OnPlayerHitBlockClientEvent，新增auxValue参数

40. 调整OnCommandOutputClientEvent，分类从“玩家”改为“世界”

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

1. 废弃GenerateColor，请使用ColorCode枚举

2. 废弃DefineEvent，监听自定义事件前不再需要DefineEvent

3. 废弃GetEntityIdentifier，请使用GetEngineTypeStr

4. 废弃GetItemEntityItemIdentifier，请使用GetDroppedItem

5. 废弃SetHurtByEntity，请使用Hurt

6. 废弃IsSneaking，请使用isSneaking

7. 废弃IsSwiming，请使用isSwimming

8. 废弃BindModelSfx，请使用CreateEngineSfx或CreateEngineSfxFromEditor创建序列帧，并使用Bind绑定骨骼模型

9. 废弃Create，请使用CreateEngineSfxFromEditor

10. 废弃SetVisible，推荐使用UI面向对象BaseUIControl.SetVisible接口

11. 废弃GetVisible，推荐使用UI面向对象BaseUIControl.GetVisible接口

12. 废弃GetText，推荐使用UI面向对象LabelUIControl.GetText接口

13. 废弃SetText，推荐使用UI面向对象LabelUIControl.SetText接口

14. 废弃GetEditText，推荐使用UI面向对象TextEditBoxUIControl.GetEditText接口

15. 废弃SetEditText，推荐使用UI面向对象TextEditBoxUIControl.SetEditText接口

16. 废弃GetTextColor，推荐使用UI面向对象LabelUIControl.GetTextColor接口

17. 废弃SetTextColor，推荐使用UI面向对象LabelUIControl.SetTextColor接口

18. 废弃SetEditTextMaxLength，推荐使用UI面向对象TextEditBoxUIControl.SetEditTextMaxLength接口

19. 废弃SetTextFontSize，推荐使用UI面向对象LabelUIControl.SetTextFontSize接口

20. 废弃SetPosition，推荐使用UI面向对象BaseUIControl.SetPosition接口

21. 废弃GetPosition，推荐使用UI面向对象BaseUIControl.GetPosition接口

22. 废弃SetAlpha，推荐使用UI面向对象BaseUIControl.SetAlpha接口

23. 废弃SetSize，推荐使用UI面向对象BaseUIControl.SetSize接口

24. 废弃GetSize，推荐使用UI面向对象BaseUIControl.GetSize接口

25. 废弃SetSprite，推荐使用UI面向对象ImageUIControl.SetSprite接口

26. 废弃SetSpriteColor，推荐使用UI面向对象ImageUIControl.SetSpriteColor接口

27. 废弃SetSpriteGray，推荐使用UI面向对象ImageUIControl.SetSpriteGray接口

28. 废弃SetSpriteUV，推荐使用UI面向对象ImageUIControl.SetSpriteUV接口

29. 废弃SetSpriteUVSize，推荐使用UI面向对象ImageUIControl.SetSpriteUVSize接口

30. 废弃SetSpriteClipRatio，推荐使用UI面向对象ImageUIControl.SetSpriteClipRatio接口

31. 废弃SetTouchEnable，推荐使用UI面向对象BaseUIControl.SetTouchEnable接口

32. 废弃AddTouchEventHandler，推荐使用UI面向对象ButtonUIControl.AddTouchEventParams接口开启按钮回调功能并通过SetButtonTouchUpCallback等接口绑定回调函数

33. 废弃RenderPaperDoll，推荐使用UI面向对象NeteasePaperDollUIControl.RenderEntity接口渲染实体或NeteasePaperDollUIControl.RenderSkeletonModel接口渲染骨骼模型

34. 废弃SetGridDimension，推荐使用UI面向对象GridUIControl.SetGridDimension接口

35. 废弃SetToggleState，推荐使用UI面向对象SwitchToggleUIControl.SetToggleState接口

36. 废弃SetScrollViewPos，推荐使用UI面向对象ScrollViewUIControl.SetScrollViewPos接口

37. 废弃GetScrollViewPos，推荐使用UI面向对象ScrollViewUIControl.GetScrollViewPos接口

38. 废弃SetScrollViewPercentValue，推荐使用UI面向对象ScrollViewUIControl.SetScrollViewPercentValue接口

39. 废弃GetNeteasePaperDollModelId，推荐使用UI面向对象NeteasePaperDollUIControl.GetModelId接口

40. 废弃ServerExplosionBlockEvent，请使用ExplosionServerEvent

41. 废弃PistonFacing，请使用Facing枚举