10 KiB
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已经被整合进下拉按钮