# 2.1
2022.4.15：版本号（v2.1 BE1.17.3）
包括Mod PC包，手机测试版启动器，和服务器引擎。
- 新增重大功能介绍
- 自定义盾牌
对盾牌的自定义进行了支持，并且额外支持了盾牌的动画和模型，具体的使用请参考 自定义盾牌 。
Demo见： 示例简介
- 方块合并网格体 & 设置网格体为实体模型
主要实现了3个功能。
1）获取指定的方块为一个方块调色板，调色板内记录有各方块的位置和类型，参考GetBlockPaletteFromPosList(服务端)以及其他接口。
2）使用方块调色板生成对应的网格体模型，参考CombineBlockPaletteToGeometry(客户端)以及其他接口。
3）为实体添加指定的网格体模型，参考AddActorBlockGeometry(客户端)。
如下图，就是将一些方块合并为了网格体模型，并赋予一个可骑乘实体，实现了类似组装战车的效果。
Demo见： 示例简介
- 提供更多中国版群系源节点类型
2.1版本的群系源节点能做到以下功能： 1）将某个群系的部分替换成另外一个群系 2）当群系A与群系B相邻时，则在他们中间生成过渡群系 3）在核心群系的周围生成伴生群系 4）在一个固定长宽的矩形范围内，随机选择一个点放置关键群系 5）根据molang语句来实现群系源控制
- 自定义战利品表扩展
玩家新增幸运值属性，影响战利品数量和权重，详见： 战利品池 和属性值。
- UI控件支持更多设置属性接口
详见UI控件。
- 新增屏蔽原版大型结构的10个json组件
可以在维度配置中屏蔽一些大型结构，详见： 维度配置
- 新增定义物品描述信息的json字段
新增 netease:customtips 字段，详见： netease-customtips
- 新增
新增StartMemProfile(服务端)， 开始启动服务端脚本内存分析
新增StopMemProfile(服务端)， 停止服务端脚本内存分析并生成火焰图
新增StartMemProfile(客户端)， 开始启动客户端脚本内存分析
新增StopMemProfile(客户端)， 停止客户端脚本内存分析并生成火焰图
新增GetBlankBlockPalette(服务端)， 获取一个空白的方块调色板
新增GetBlockPaletteFromPosList(服务端)， 根据输入的方块位置列表创建并获取一个方块调色板
新增GetBlockPaletteBetweenPos(服务端)， 根据输入的两个方块位置创建并获取一个方块调色板
新增SetBlockByBlockPalette(服务端)， 根据输入的方块调色板内容，将调色板内记录的所有方块设置为实际的方块。
新增GetBlockBasicInfo(服务端)， 获取方块基本信息
新增SetBlockBasicInfo(服务端)， 设置方块基本信息
新增GetBlockCollision(服务端)， 获取指定位置方块当前collision的aabb接口
新增GetBlockClip(服务端)， 获取指定位置方块当前clip的aabb接口
新增IsSlimeChunk(服务端)， 获取某个区块是否史莱姆区块。
新增OpenMobHitBlockDetection(服务端)， 开启碰撞方块的检测接口
新增CloseMobHitBlockDetection(服务端)， 关闭碰撞方块的检测接口
新增SetJumpPower(服务端)， 设置生物跳跃力度
新增SetEntityInteractFilter(服务端)， 设置与生物可交互的条件
新增GetPlayerUIItem(服务端)， 获取合成容器的物品
新增GetItemDefenceAngle(服务端)， 获取盾牌物品的抵挡角度范围
新增SetItemDefenceAngle(服务端)， 设置盾牌物品的抵挡角度范围
新增SetInputSlotItem(服务端)， 设置熔炉输入栏物品
新增GetInputSlotItem(服务端)， 获取熔炉输入栏物品
新增GetOutputSlotItem(服务端)， 获取熔炉输出栏物品
新增GetIsBlocking(服务端)， 获取玩家是否处于抵挡状态
新增AddBrewingRecipes(服务端)， 新增添加酿造台配方的接口
新增SetEntityShareablesItems(服务端)， 设置实体可分享/可拾取的物品列表
新增AddActorRenderControllerArray(客户端)， 添加实体渲染控制器数组中字典arrays元素
新增AddActorBlockGeometry(客户端)， 为实体添加方块几何体模型
新增DeleteActorBlockGeometry(客户端)， 删除实体中的指定方块几何体模型
新增ClearActorBlockGeometry(客户端)， 删除实体中的所有的方块几何体模型
新增SetActorBlockGeometryVisible(客户端)， 设置实体中指定的方块几何体模型是否显示
新增SetActorAllBlockGeometryVisible(客户端)， 设置实体中所有的方块几何体模型是否显示
新增GetBlankBlockPalette(客户端)， 获取一个空白的方块调色板
新增GetBlockPaletteFromPosList(客户端)， 根据输入的方块位置列表创建并获取一个方块调色板
新增GetBlockPaletteBetweenPos(客户端)， 根据输入的两个位置创建并获取一个方块调色板
新增CombineBlockPaletteToGeometry(客户端)， 将BlockPalette中的所有方块合并并转换为能用于实体的几何体模型
新增CombineBlockBetweenPosToGeometry(客户端)， 根据输入的两个位置，搜索这两个位置之间的所有方块，并将这些方块合并和转换为能用于实体的几何体模型
新增CombineBlockFromPosListToGeometry(客户端)， 根据输入的两个位置，搜索这两个位置之间的所有方块，并将这些方块合并和转换为能用于实体的几何体模型
新增GetBlockClip(客户端)， 获取指定位置方块当前clip的aabb
新增GetBlockCollision(客户端)， 获取指定位置方块当前collision的aabb
新增SetHealthBarDeviation(客户端)， 新增设置血条高度的接口
新增GetTexture(客户端)， 获取模型贴图名称路径
新增setUsingShield(客户端)， 激活盾牌状态
新增SetFullSize(客户端)， 设置控件的大小，支持百分比以及绝对值
新增GetFullSize(客户端)， 获取控件的大小，支持比例值以及绝对值
新增SetFullPosition(客户端)， 设置控件的锚点坐标（全局坐标），支持比例值以及绝对值
新增GetFullPosition(客户端)， 获取控件的锚点坐标，支持比例值以及绝对值
新增SetAnchorFrom(客户端)， 设置控件相对于父节点的锚点
新增GetAnchorFrom(客户端)， 判断控件相对于父节点的哪个锚点来计算位置与大小
新增SetAnchorTo(客户端)， 设置控件自身锚点位置
新增GetAnchorTo(客户端)， 获取控件自身锚点位置信息
新增SetClipOffset(客户端)， 设置控件的裁剪偏移信息
新增GetClipOffset(客户端)， 获取控件的裁剪偏移信息
新增SetClipsChildren(客户端)， 设置控件是否开启裁剪内容
新增GetClipsChildren(客户端)， 根据控件路径返回某控件是否开启裁剪内容
新增SetMaxSize(客户端)， 设置控件所允许的最大的大小值
新增GetMaxSize(客户端)， 获取控件所允许的最大的大小值
新增SetMinSize(客户端)， 设置控件所允许的最小的大小值
新增GetMinSize(客户端)， 获取控件所允许的最小的大小值
新增asStackPanel(客户端)， 将当前BaseUIControl转换为StackPanelUIControl实例
新增asInputPanel(客户端)， 将当前BaseUIControl转换为InputPanelUIControl实例
新增SetClipDirection(客户端)， 设置图片控件的裁剪方向
新增GetClipDirection(客户端)， 获取图片控件的裁剪方向
新增SetImageAdaptionType(客户端)， 设置图片控件的图片适配方式以及信息
新增SetIsModal(客户端)， 设置当前面板是否为模态框
新增GetIsModal(客户端)， 判断当前面板是否为模态框
新增SetTextAlignment(客户端)， 设置文本控件的文本对齐方式
新增GetTextAlignment(客户端)， 获取文本控件的文本对齐方式
新增SetTextLinePadding(客户端)， 设置文本控件的行间距
新增GetTextLinePadding(客户端)， 获取文本控件的行间距
新增EnableTextShadow(客户端)， 使文本控件显示阴影
新增DisableTextShadow(客户端)， 关闭文本控件显示阴影
新增IsTextShadowEnabled(客户端)， 判断文本控件是否显示阴影
新增SetOrientation(客户端)， 设置stackPanel的排列方向
新增GetOrientation(客户端)， 获取stackPanel的排列方向
新增SerializeBlockPalette(客户端/服务端)， 序列化方块调色板中的数据，用于方块调色板在客户端及服务端的事件数据之间传输
新增DeserializeBlockPalette(客户端/服务端)， 反序列化方块调色板数据字典中的数据，用于方块调色板在客户端及服务端的事件数据之间传输
新增GetBlockCountInBlockPalette(客户端/服务端)， 获取方块调色板BlockPalette中某个类型的方块的数量
新增DeleteBlockInBlockPalette(客户端/服务端)， 删除方块调色板BlockPalette中某个类型的方块
新增ReplaceBlockInBlockPalette(客户端/服务端)， 替换方块调色板BlockPalette中某个类型的方块
新增ReplaceAirByStructureVoid(客户端/服务端)， 设置是否将方块调色板BlockPalette中所有空气替换为结构空位
新增GetVolumeOfBlockPalette(客户端/服务端)， 获取方块调色板BlockPalette所占据的长方体的长宽高
新增GetLocalPosListOfBlocks(客户端/服务端)， 获取方块调色板中某种方块的相对位置列表
新增OnGroundServerEvent(服务端)， 服务端实体着地事件
新增FurnaceBurnFinishedServerEvent(服务端)， 服务端熔炉烧制触发事件
新增UIContainerItemChangedServerEvent(服务端)， 新增合成容器物品变化事件
新增ContainerItemChangedServerEvent(服务端)， 新增容器物品变化事件
新增OnMobHitBlockServerEvent(服务端)， 生物和方块碰撞事件
新增HealthChangeBeforeServerEvent(服务端)， 生物生命值发生变化之前的事件
新增EntityDroppedItemServerEvent(服务端)， 生物扔出物品时触发的事件
新增EntityPickupItemServerEvent(服务端)， 生物拾取物品时触发的事件（玩家不触发）
新增OnPlayerBlockedByShieldBeforeServerEvent(服务端)， 玩家使用盾牌抵挡伤害之前触发的事件
新增OnPlayerBlockedByShieldAfterServerEvent(服务端)， 玩家使用盾牌抵挡伤害之后触发的事件
新增OnPlayerActiveShieldServerEvent(服务端)， 玩家激活盾牌触发的事件
新增BlockDestroyByLiquidServerEvent(服务端)， 方块被水流破坏的事件
新增FarmBlockToDirtBlockServerEvent(服务端)， 耕地退化为泥土时触发
新增DirtBlockToGrassBlockServerEvent(服务端)， 泥土方块变成草方块时触发
新增GrassBlockToDirtBlockServerEvent(服务端)， 草方块变成泥土方块时触发
新增PlayerDoInteractServerEvent(服务端)， 玩家与生物交互时触发的事件
新增BlockBreathability， 方块的可呼吸性
新增ItemCategory， 物品所属创造栏类型
新增RenderControllerArrayType， 渲染控制器字典中材质、贴图、模型的枚举值
新增RenderLayer， 方块渲染时的材质类型
- 调整
调整GetLiquidBlock(服务端)， 增加一下备注
调整SetAddArea(服务端)， 新增fill指令说明
调整SetBlockControlAi(服务端)， 新增是否冻结动作的参数
调整GetEntitiesAround(服务端)， 增加过滤器中subject的说明
调整CraftItemOutputChangeServerEvent(服务端)， 新增当前界面类型参数
示例Demo下载地址：2.1 Demo (opens new window)。
网易大神
扫码下载网易大神