# 3.5
2025.8.19：版本号（V3.5 BE1.21.00）包括Mod PC包，手机测试版启动器，和服务器引擎。
示例Demo：前往此处下载
# 一、更新时间表
- 在2025年8月20日上线3.5第一个Beta版。
- 在2025年9月03日上线3.5第二个Beta版。
- 在2025年9月17日上线3.5稳定版。
- 在2025年9月19日，全渠道将更新3.5版本玩家包体，玩家将陆续更新到3.5版本，请开发者合理安排更新节奏。
# 二、重要功能更新
自定义容器适配迭代，详细请前往自定义容器查看
- 新增hopper配置字段，可将自定义容器变为漏斗，支持控制是否漏入漏出、设置漏入的面个数、设置漏入的槽位位置
- 对于netease_container，SpawnItemToContainer支持设置物品；对于netease_ui_container，GetPlayerUIItem(服务端)和SetPlayerUIItem(服务端)新增isNeteaseUI参数，为true时支持获取和设置物品
- 新增PlayerTryAddCustomContainerItemServerEvent(服务端)事件，将在同一槽位物品数量改变时触发
- 新增PlayerTryRemoveCustomContainerItemServerEvent(服务端)事件，将在取出物品时触发
- 新增漏斗漏入事件ItemPushInCustomContainerServerEvent(服务端)和漏斗漏出事件ItemPullOutCustomContainerServerEvent(服务端)，支持cancel取消
- 调整PlayerTryPutCustomContainerItemServerEvent(服务端)， collectionName改为对应容器json中"custom_description"字段，新增collectionType（netease_container和netease_ui_container）代替原collectionName
新增自定义绘制渲染接口，开发者可以使用其绘制盒子、圆、球、线条、文本、箭头形状，支持创建后设置颜色、缩放、位置等。同时该功能所有接口采用面向对象设计，方便开发者使用
hud_screen.json 字段更新。在3.5版本中，为了适配原版更新，影响物品栏和经验栏可见性的部分json字段名称发生了变更
- 变更包括：
- "#exp_and_hotbar_visible" ——> "#hotbar_with_xp_bar"
- "#only_hotbar_visible" ——> "#hotbar_no_xp_bar"
- 影响范围：
- 原生指令：/hud
- SDK接口：HideSlotBarGui、HideExpGui
- 适配方法：
- 如果MOD里还存在老版的hud_screen.json使用旧的字段，可能会覆盖上述字段更新，导致上述相关的指令或API失效，引发物品栏的一些可见性控制bug，请开发者检查并进行替换
- 变更包括：
支持获取/设置实体行为包properties，让开发者更方便控制生物行为
Matrix、Quaternion、Vector3将有底层C++进行计算，拥有更快速度，方便开发者实现自定义碰撞箱计算等
新增权限变更事件PlayerPermissionChangeServerEvent(服务端)和PlayerPermissionChangeClientEvent(客户端)，参数支持cancel，和获取权限变更的原因枚举PermissionChangeCause
# 三、API更新
- 新增
新增GetAllProperties(服务端)， 获取实体属性列表
新增SetPropertyValue(服务端)， 设置实体属性的值
新增AddBoxShape(客户端)， 新建盒子形状
新增AddLineShape(客户端)， 新建线条形状
新增AddCircleShape(客户端)， 新建圆形状
新增AddArrowShape(客户端)， 新建箭头形状
新增AddTextShape(客户端)， 新建文本形状
新增AddSphereShape(客户端)， 新建球形状
新增RemoveAll(客户端)， 删除当前所有Shape
新增GetPos(客户端)， 获取Shape的位置
新增GetBoxScale(客户端)， 获取BoxShape的大小
新增GetColor(客户端)， 获取Shape的颜色
新增GetType(客户端)， 获取Shape的类型
新增GetPriority(客户端)， 获取Shape的优先级
新增GetVisible(客户端)， 获取Shape是否可见
新增GetEndPos(客户端)， 获取LineShape或ArrowShape的结束位置
新增GetRadius(客户端)， 获取CircleShape或ArrowShape或SphereShape的半径
新增GetSegments(客户端)， 获取CircleShape或ArrowShape头部的分段数
新增GetText(客户端)， 获取TextShape的文本
新增GetLength(客户端)， 获取ArrowShape的头部长度
新增SetPos(客户端)， 设置Shape的位置
新增SetBoxScale(客户端)， 设置BoxShape的大小
新增SetEndPos(客户端)， 设置LineShape或ArrowShape的结束位置
新增SetRadius(客户端)， 设置CircleShape或ArrowShape或SphereShape的半径
新增SetSegments(客户端)， 设置组成ArrowShape头部的网格数量
新增SetLength(客户端)， 设置组成ArrowShape头部的长度
新增SetText(客户端)， 设置TextShape的文本内容
新增SetColor(客户端)， 设置Shape的颜色
新增SetPriority(客户端)， 设置Shape的渲染优先级, 同一像素点处优先渲染优先级高的Shape, 默认为0
新增SetVisible(客户端)， 设置Shape是否可见
新增Remove(客户端)， 删除Shape
新增SetDropItemTransform(客户端)， 设置通过AddDropItemToWorld添加的掉落物的位置、角度和缩放
新增PlayerTryAddCustomContainerItemServerEvent(服务端)， 玩家尝试将物品添加到自定义容器时触发该事件（当目标槽位已有同种物品时触发）
新增PlayerTryRemoveCustomContainerItemServerEvent(服务端)， 玩家尝试从自定义容器中移除物品时触发该事件
新增PlayerPermissionChangeServerEvent(服务端)， 玩家权限变更事件
新增ItemPushInCustomContainerServerEvent(服务端)， 漏斗漏入物品时触发该事件
新增ItemPullOutCustomContainerServerEvent(服务端)， 漏斗漏出物品时触发该事件
新增PlayerPermissionChangeClientEvent(客户端)， 玩家权限变更事件
新增PlayerTryPutCustomContainerItemClientEvent(客户端)， 玩家尝试将物品放入自定义容器时触发该事件
新增PlayerTryAddCustomContainerItemClientEvent(客户端)， 玩家尝试将物品添加到自定义容器时触发该事件（当目标槽位已有同种物品时触发）
新增PlayerTryRemoveCustomContainerItemClientEvent(客户端)， 玩家尝试从自定义容器中移除物品时触发该事件
新增PermissionChangeCause， 玩家权限变更原因枚举
新增ShapeType， 调试图形枚举
- 调整
调整CreateUI(客户端)， 添加备注
调整GetPlayerUIItem(服务端)， 新增isNeteaseUI参数，默认为false，true时获取netease_ui_container的物品
调整SetPlayerUIItem(服务端)， 新增isNeteaseUI参数，默认为false，true时设置netease_ui_container的物品
调整SpawnItemToContainer(服务端)， 支持自定义容器
调整PlayerTryPutCustomContainerItemServerEvent(服务端)， collectionName改为对应容器json中"custom_description"字段，新增collectionType代替原collectionName
调整PlayerPermissionChangeServerEvent(服务端)， 新增发起者id
- 废弃（将在未来不可用）
- 废弃HideReportGUI，举报按钮原生UI已经被整合进下拉按钮