# 2.11

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

示例Demo：前往此处下载

# 一、更新时间表

在2024年3月19日上线2.11第一个Beta版。
在2024年4月2日上线2.11第二个Beta版。
在2024年4月11日上线2.11稳定版。
在2024年4月19日，全渠道将更新2.11版本玩家包体，玩家将陆续更新到2.11版本，请开发者合理安排更新节奏。

# 二、重要功能更新

新增支持矩阵概念及其基本运算，详情参考Matrix。
新增陀螺仪系列接口，支持获取陀螺仪数据，控制上报频率，详情参考ToggleGyroSensor 等接口。
方块新增支持配置燃烧时长，详见netease:fuel组件。
方块新增支持配置最大堆叠数量，详见minecraft:max_stack_size组件。
新增根据权重控制多动画混合接口，详见SetAnim1DMultiControlParam接口。
新增支持动态添加后处理定义的接口，详见AddPostProcess。
后处理支持将某一pass处理结果传递到其他pass接口，详见PostPassResultToOtherPass。
屏幕拾取与射线检测等接口支持返回更精确的浮点数命中坐标，详见PickFacing、GetChosen和getEntitiesOrBlockFromRay三个接口。
新增一套实体AOI检测接口，详见CreateEntityAOI。
新增获取记分板记分项和玩家记分项的功能，详见GetAllScoreboardObjects和GetAllPlayerScoreboardObjects接口。
新增设置玩家滑动条类设置的接口，如视野、亮度、灵敏度等等，详见SetSliderOption接口。
新增支持自定义伤害类型，可在设置伤害Hurt接口中传入伤害来源标签，并在相关的受伤事件参数中获取到对应的伤害来源标签。
新增一系列判断玩家控制状态的接口，详情参考IsCanMove等接口。
新增模拟玩家攻击生物的接口，详情参考PlayerAttackEntity。
Pushscreen和Popscreen接口调用时现在会触发对应的OnActive和OnDeactive两个UI的生命周期函数，详见界面创建流程及生命周期。

# 三、API更新

新增

新增GetOriginAreaOffset(客户端)，获取指定原生UI的offset,包括左上角和右下角
新增ToggleGyroSensor(客户端)，开启或关闭陀螺仪传感器采集
新增SetGyroSensorReportRate(客户端)，设置陀螺仪传感器(上报/触发)频率
新增CreateEntityAOI(服务端)，新增注册感应区域，有实体进入时和离开时会触发回调函数func
新增DeleteEntityAOI(服务端)，删除使用CreateEntityAOI注册的感应区
新增GetAllScoreboardObjects(服务端)，获取所有记分板项
新增GetAllPlayerScoreboardObjects(服务端)，获取玩家记分项
新增GetEntityDamage(服务端)，获取生物(包括玩家)的攻击力
新增GetJumpPower(服务端)，获取生物跳跃力度
新增PlayerAttackEntity(服务端)，模拟玩家攻击某个生物
新增GetAllScoreboardObjects(客户端)，获取所有记分板项
新增GetAllPlayerScoreboardObjects(客户端)，获取玩家记分项
新增RegisterAnim1DMultiControlParam(客户端)，新增多动作融合功能接口：注册用于根据权重控制多动画进行混合的参数
新增SetAnim1DMultiControlParam(客户端)，新增多动作融合功能接口：设置用于根据权重控制多动画进行混合的参数
新增RemoveAnim1DMultiControlParam(客户端)，新增多动作融合功能接口：删除用于根据权重控制多动画进行混合的参数
新增IsCanMove(客户端)，获取玩家是否响应移动
新增IsCanJump(客户端)，获取玩家是否响应跳跃（以及在水中浮起）
新增IsCanAttack(客户端)，获取玩家是否响应攻击
新增IsCanWalkMode(客户端)，获取玩家是否响应切换行走模式
新增IsCanPerspective(客户端)，获取玩家是否响应切换视角
新增IsCanPause(客户端)，获取玩家是否响应暂停按钮
新增IsCanChat(客户端)，获取玩家是否响应聊天按钮
新增IsCanScreenShot(客户端)，获取玩家是否响应截图按钮
新增IsCanOpenInv(客户端)，获取玩家是否响应打开背包按钮
新增IsCanDrag(客户端)，获取玩家是否响应屏幕拖动
新增IsCanInair(客户端)，获取玩家是否响应打上升下降按钮
新增CreateBindEntityNew(客户端)，创建粒子发射器并绑定实体
新增GetSliderOption(客户端)，获得某个滑动条设置选项的值
新增SetSliderOption(客户端)，设置某个滑动条设置选项的值
新增PostPassResultToOtherPass(客户端)，将自定义pass的纹理结果传递到其他自定义pass的fragmentShader指定纹理单元槽位
新增AddPostProcess(客户端)，添加后处理效果，与graphics_settings/post_process.json定义的process等效
新增GetPostProcessOrder(客户端)，获取后处理效果的渲染顺序
新增GetUiItem(客户端)，新增获取ItemRenderer控件显示的物品接口
新增EntityDieLoottableAfterServerEvent(服务端)，生物死亡掉落物品之后事件
新增GyroSensorChangedClientEvent(客户端)，陀螺仪传感器姿态发生变化事件
新增OriginGUIName，获取原生UI名字
新增SliderOptionId，滑动条设置选项枚举值

调整

调整getEntitiesOrBlockFromRay(服务端)，返回值中添加精准碰撞坐标hitPos，类型为tuple(float,float,float)
调整GetChunkMinPos(服务端)，修复末地、下界的值异常,改用entityId创建组件后，即获取正常
调整GetChunkMaxPos(服务端)，修复末地、下界的值异常,改用entityId创建组件后，即获取正常
调整Hurt(服务端)， cause类型新增Custom类型，新增customTag参数标识自定义伤害来源，可在ActorHurtServerEvent、ActuallyHurtServerEvent、DamageEvent、PlayerHurtEvent、PlayerDieEvent、MobDieEvent监听到标识
调整GetItemBasicInfo(服务端)，物品类型添加trident、potion、crossbow
调整PickFacing(客户端)，返回值中添加精准碰撞坐标hitPosX、 hitPoxY、hitPosZ, 三者均为float类型
调整GetChosen(客户端)，返回值中添加精准碰撞坐标hitPosX、 hitPoxY、hitPosZ, 三者均为float类型
调整GetItemBasicInfo(客户端)，物品类型添加trident、potion、crossbow
调整AddEntityMarker(客户端)，增加是否反转z轴朝向
调整DamageEvent(服务端)，新增customTag参数，用于接收使用Hurt接口传入的自定义伤害类型
调整ActuallyHurtServerEvent(服务端)，新增customTag参数，用于接收使用Hurt接口传入的自定义伤害类型
调整MobDieEvent(服务端)，新增cause与customTag参数，cause用于标明伤害来源，详见Minecraft枚举值文档的ActorDamageCause，customTag用于接收使用Hurt接口传入的自定义伤害类型
调整PlayerHurtEvent(服务端)，新增cause与customTag参数，cause用于标明伤害来源，详见Minecraft枚举值文档的ActorDamageCause，customTag用于接收使用Hurt接口传入的自定义伤害类型
调整PlayerDieEvent(服务端)，新增cause与customTag参数，cause用于标明伤害来源，详见Minecraft枚举值文档的ActorDamageCause，customTag用于接收使用Hurt接口传入的自定义伤害类型
调整ActorHurtServerEvent(服务端)，新增customTag参数，用于接收使用Hurt接口传入的自定义伤害类型
调整StartDestroyBlockServerEvent(服务端)，新增face参数
调整EntityEffectDamageServerEvent(服务端)，新增cause参数，标明伤害来源，详见Minecraft枚举值文档的ActorDamageCause。
调整StartDestroyBlockClientEvent(客户端)，新增face参数
调整ActorDamageCause，新增Custom枚举，用于在Hurt接口标识为自定义伤害来源

废弃（将在未来不可用）

废弃GetEntityInArea，请使用GetEntitiesInSquareArea接口
废弃CreateBindEntity，接口存在无法修复的问题，强烈建议使用CreateBindEntityNew接口

← 2.12 2.10 →