# 3.10

2026.9.23：版本号（V3.10 BE1.21.130）包括Mod PC包，手机测试版启动器，和服务器引擎。

示例Demo：前往此处下载

# 一、更新时间表

在2026年9月24日上线3.10第一个Beta版。有以下注意事项:
- 3.9Beta包起，不再提供RenderDragon渲染龙、OpenGL两个包体，两个包体现已合并，默认为OpenGL渲染模式
- 局内切换渲染引擎目前仍需要完善，开发者需要在MCS创建世界的时候选择渲染引擎，在MCS创建世界时选择渲染引擎后，即可切换渲染模式
在2026年10月14日上线3.10第二个Beta版。
在2026年10月28日上线3.10稳定版。
在2026年10月30日，全渠道将更新3.10版本玩家包体，玩家将陆续更新到3.10版本，请开发者合理安排更新节奏。
- 在测试过程中发现的BUG，请及时通过开发者平台以及GithubSDK反馈页进行反馈

# 二、重要功能更新

物理系统
- 注意：物理系列的接口为实验性内容，在后期版本中可能会存在接口变更、开发环境变更等情况。请各位开发者合理安排开发内容与正式版本，避免后续版本物理系统更新后出现模组失效的情况
- 新增质量功能，新增SetMass(服务端)、GetMass(服务端)，可设置/获取刚体的质量，做一些更精细的物理模拟
- 新增关节功能，新增CreateFixedJoint(服务端)、CreateDistanceJoint(服务端)、CreateSphericalJoint(服务端)、CreateRevoluteJoint(服务端)、CreatePrismaticJoint(服务端)等接口，支持固定、距离、球窝、铰链、滑动五类关节，可设置关节的角度/行程限制、电机驱动以及断裂阈值（SetJointBreakForce(服务端)），配合PhysXJointBreakServerEvent(服务端)事件，用于制作门、吊桥、可断裂结构等物理玩法
- 调色板支持更多模型，CombineBlockPaletteToGeometry(客户端)等调色板接口新增支持自定义方块实体外观、国际版方块外观(minecraft:geometry组件)、花盆、钟、潮涌核心、旗帜、铜箱、铜傀儡像、水方块、火方块
- 物理系统相关教程请见物理的使用指南
屏幕坐标与世界坐标
- 由于移动端没有严格意义的准星，导致一些需要准星判断的内容无法实现，所以我们收集相关开发者的反馈并调研开发了下述接口，后续如有有关类似接口的迭代建议请通过开发者平台以及GithubSDK反馈页进行反馈
- 这里仅提供基本能力，具体计算方法开发者需自行处理，官方暂时不做API封装
- 新增GetWorldRayFromScreenPoint(客户端)，屏幕坐标转世界射线，返回射线原点（近平面上的点）与单位方向向量
- 新增WorldToScreenPoint(客户端)，世界坐标转屏幕坐标，返回屏幕坐标、归一化深度与是否在屏幕可见范围内
- 新增GetViewMatrix(客户端)，获取视图矩阵，返回GameRenderer每帧缓存的mLastLevelViewMatrix
- 新增GetProjectionMatrix(客户端)，获取投影矩阵，返回GameRenderer每帧缓存的mLastLevelProjMatrix
- 新增GetNearFarPlane(客户端)，获取近远裁剪面距离
- 新增GetAspectRatio(客户端)，获取画面宽高比
联机大厅接口更新
- 新增房间信息与元数据相关接口，新增GetRoomInfo(服务端)、GetRoomMeta(服务端)、SetRoomMeta(服务端)、GetPlayerRoomId(服务端)，可获取房间id、人数、房主等房间信息，设置/获取房间元数据用于房间间数据同步
- 新增房主管理相关接口，新增GetHostPlayerUid(服务端)、TransferRoomHost(服务端)、TransferRoomHostByUid(服务端)，可获取房主uid并将房主转移给指定在线玩家
- 新增踢人相关接口，新增KickPlayer(服务端)、KickPlayerByUid(服务端)，可自定义踢出提示信息踢出指定玩家（房主除外）
- 新增RoomHostChangedServerEvent(服务端)事件，房主转移时触发，可用于监听房主变化并做相应处理
Tags功能更新
- 新增方块tag查询接口LookupBlocksByBlockTag(服务端/客户端)，根据netease_tags中注册的方块tag名查找该tag下所有方块，支持#引用的标签自动展开；同一tag名被多个模组注册时自动合并去重；未注册的原版tag也可直接查询
- 新增物品tag查询接口LookupItemsByItemTag(服务端/客户端)，根据netease_tags中注册的物品tag名查找该tag下所有物品，支持#引用的标签自动展开与多模组合并去重，未注册的原版tag也可直接查询
- netease_tags的配置方法请见自定义标签

# 三、其他重要调整

clouds.png贴图问题
- 注意：由于游戏引擎原生限制，目前clouds.png云层贴图不得使用 1x1 大小，否则会被强制替换成纯白的颜色，请选择其他像素的云层贴图

# 3.10

新增

新增LookupBlocksByBlockTag(服务端)，根据方块tag查找方块列表
新增LookupItemsByItemTag(服务端)，根据物品tag查找物品列表
新增GetRoomInfo(服务端)，获取联机大厅房间信息
新增KickPlayer(服务端)，踢出玩家接口，可自定义踢出信息
新增KickPlayerByUid(服务端)，支持传uid踢出玩家
新增GetHostPlayerUid(服务端)，获取联机大厅房主uid
新增TransferRoomHost(服务端)，转移联机大厅房主
新增TransferRoomHostByUid(服务端)，通过uid转移联机大厅房主
新增SetRoomMeta(服务端)，设置联机大厅房间元数据
新增GetRoomMeta(服务端)，异步获取指定联机大厅房间的元数据
新增GetPlayerRoomId(服务端)，根据玩家uid获取所在房间id
新增ConnectPvd(服务端)，连接 PhysX Visual Debugger
新增DisconnectPvd(服务端)，断开 PhysX Visual Debugger
新增RemoveShape(服务端)，删除指定碰撞 shape
新增GetShapeCount(服务端)，获取碰撞 shape 数量
新增GetShapeInfo(服务端)，获取碰撞 shape 信息
新增RemoveShapeByUserData(服务端)，按 userData 删除碰撞 shape
新增SetLinearDamping(服务端)，设置线性阻尼
新增SetAngularDamping(服务端)，设置角阻尼
新增SetMass(服务端)，设置刚体质量
新增GetRigidBodyFlags(服务端)，获取刚体标记
新增GetRigidDynamicLockFlags(服务端)，获取动态刚体锁定标记
新增GetActorFlags(服务端)，获取 Actor 标记
新增IsDefaultPxActor(服务端)，判断是否为默认 PxActor
新增GetMass(服务端)，获取刚体质量
新增GetLinearVelocity(服务端)，获取线速度
新增SetLinearVelocity(服务端)，设置线速度
新增AddTorqueLocal(服务端)，在刚体本地坐标系中添加扭矩
新增GetAngularVelocity(服务端)，获取角速度
新增SetAngularVelocity(服务端)，设置角速度
新增SetMaxAngularVelocity(服务端)，设置最大角速度；maxVel 必须为有限正数，否则返回 False
新增SetMaxLinearVelocity(服务端)，设置最大线速度
新增SetSceneGravity(服务端)，设置指定维度的 PhysX 场景重力
新增SampleBuoyancy(服务端)，采样刚体在水面下的体积和浮力
新增SetRemoteVisualSync(服务端)，配置远距离物理刚体的视觉同步降帧
新增ClearRemoteVisualSync(服务端)，清除远距离视觉同步配置
新增IsSleeping(服务端)，查询刚体休眠状态
新增WakeUp(服务端)，唤醒刚体
新增PutToSleep(服务端)，令刚体进入休眠
新增SetCMassLocalPose(服务端)，设置质心局部位置
新增GetMassSpaceInertiaTensor(服务端)，获取质量空间惯性张量
新增CreateFixedJoint(服务端)，创建固定关节
新增CreateDistanceJoint(服务端)，创建距离关节
新增CreateSphericalJoint(服务端)，创建球形关节
新增CreateRevoluteJoint(服务端)，创建旋转关节
新增CreatePrismaticJoint(服务端)，创建滑动关节
新增DestroyJoint(服务端)，销毁关节
新增DestroyJointsForEntity(服务端)，销毁实体关联的关节
新增DestroyAllJoints(服务端)，销毁全部关节
新增SetJointCollisionEnabled(服务端)，设置相连刚体是否相互碰撞
新增IsJointBroken(服务端)，查询关节断裂状态
新增GetRevoluteJointAngle(服务端)，获取旋转关节角度
新增GetRevoluteJointVelocity(服务端)，获取旋转关节角速度
新增GetJointFrames(服务端)，获取关节两端的本地和世界 frame
新增SetDistanceJointParams(服务端)，设置距离关节参数
新增SetSphericalJointLimitCone(服务端)，设置球形关节锥形限制
新增SetRevoluteJointLimit(服务端)，设置旋转关节角度限制
新增SetPrismaticJointLimit(服务端)，设置滑动关节行程限制
新增SetRevoluteJointDrive(服务端)，设置旋转关节电机
新增SetActorBlockGeometryRotationQuat(客户端)，使用四元数设置实体的方块几何体模型的旋转
新增LookupBlocksByBlockTag(客户端)，根据方块tag查找方块列表
新增GetTextureAtlasUV(客户端)，获取方块纹理在atlas.terrain图集中的UV坐标位置与尺寸信息
新增SpawnDestroyParticleEffect(客户端)，在指定位置播放指定方块的破坏爆发粒子效果
新增GetWorldRayFromScreenPoint(客户端)，屏幕坐标转世界射线，返回射线原点（近平面上的点）与单位方向向量
新增WorldToScreenPoint(客户端)，世界坐标转屏幕坐标，返回屏幕坐标、归一化深度与是否在屏幕可见范围内
新增GetViewMatrix(客户端)，获取视图矩阵，返回GameRenderer每帧缓存的mLastLevelViewMatrix
新增GetProjectionMatrix(客户端)，获取投影矩阵，返回GameRenderer每帧缓存的mLastLevelProjMatrix
新增GetNearFarPlane(客户端)，获取近远裁剪面距离
新增GetAspectRatio(客户端)，获取画面宽高比
新增LookupItemsByItemTag(客户端)，根据物品tag查找物品列表
新增GetIconInfo(客户端)，获取物品图标纹理在图集中的UV坐标位置与尺寸信息
新增GetLinearVelocity(客户端)，获取自定义刚体线速度
新增GetAngularVelocity(客户端)，获取自定义刚体角速度
新增RemoveShape(客户端)，删除客户端本地碰撞 shape
新增AddBoxGeometry(客户端)，给客户端本地自定义刚体增加盒形碰撞体
新增GetShapeCount(客户端)，获取客户端本地碰撞 shape 数量
新增GetShapeInfo(客户端)，获取客户端本地碰撞 shape 信息
新增RemoveShapeByUserData(客户端)，按 userData 删除客户端本地碰撞 shape
新增SetGlobalPose(客户端)，设置客户端本地自定义刚体变换
新增PhysXPreSimulateServerEvent(服务端)，服务端 PhysX 模拟前回调
新增PhysXPostSimulateServerEvent(服务端)，服务端 PhysX 模拟后回调
新增RoomHostChangedServerEvent(服务端)，房主变更事件
新增PhysXPreSimulateClientEvent(客户端)，客户端 PhysX 模拟前回调
新增PhysXPostSimulateClientEvent(客户端)，客户端 PhysX 模拟后回调

调整

调整AddBoxGeometry(服务端)，支持给已有自定义刚体动态增加盒形碰撞体
调整AddCapsuleGeometry(服务端)，支持给已有自定义刚体动态增加胶囊形碰撞体
调整AddSphereGeometry(服务端)，支持给已有自定义刚体动态增加球形碰撞体
调整AddBoxTrigger(服务端)，支持给已有自定义刚体动态增加盒子形触发器
调整AddForce(服务端)，明确不同PxForceMode的输入单位；非法枚举值返回False
调整AddTorque(服务端)，运动学刚体调用返回 False，不再传入 PhysX
调整SetJointBreakForce(服务端)， -1 映射为不可断裂；有限阈值必须为非负有限数
调整GetJointBreakForce(服务端)，无效或已销毁的关节返回 None
调整GetJointType(服务端)，增加 4=Prismatic 滑动关节类型
调整CombineBlockPaletteToGeometry(客户端)，新增支持自定义方块实体外观、国际版方块外观(minecraft:geometry组件)、花盆、钟、潮涌核心、旗帜、铜箱、铜傀儡像、水方块、火方块
调整CombineBlockBetweenPosToGeometry(客户端)，新增支持自定义方块实体外观、国际版方块外观(minecraft:geometry组件)、花盆、钟、潮涌核心、旗帜、铜箱、铜傀儡像、水方块、火方块
调整CombineBlockFromPosListToGeometry(客户端)，新增支持自定义方块实体外观、国际版方块外观(minecraft:geometry组件)、花盆、钟、潮涌核心、旗帜、铜箱、铜傀儡像、水方块、火方块
调整PhysXJointBreakServerEvent(服务端)，断裂事件补充 breakForce、breakTorque，并支持 4=Prismatic

← WalkState Apollo更新信息 →

贡献者列表

编辑此页面=>