3.10（国际版 1.21.130）
网易在 2026 年 9 月 24 日开启 3.10 的 Beta 测试，10 月 28 日上线稳定版，10 月 30 日全渠道更新玩家包体。3.10 基于国际版 1.21.130。照例，我们进行一些关键性的内容总结。读者可以查看网易的官方文档：
我的世界开发者官网国际版对应的更新
3.10 对应国际版 1.21.130，即群骑纷争（Mounts of Mayhem）版本。该版本主要加入了矛、鹦鹉螺、骆驼尸壳等内容，与开发者相关的主要是动能武器（minecraft:kinetic_weapon、minecraft:piercing_weapon）相关的物品组件与实体意向。
另见：
群骑纷争
包体合并
从 3.9 的 Beta 包起，网易不再分别提供渲染龙（RenderDragon）与 OpenGL 两个包体，两者现已合并为单一包体，并默认使用 OpenGL 渲染模式。
注意：局内切换渲染引擎的功能目前仍需完善。开发者需要在 MCS 创建世界时先选择渲染引擎，创建完成后才可切换渲染模式。
物理系统
3.10 最重要的一次更新是物理系统的扩充，新增了大量与刚体、关节、碰撞形状相关的接口。
注意：物理系列接口属于实验性内容，后续版本可能出现接口变更、开发环境变更等情况。网易建议开发者合理安排开发内容与正式版本，避免物理系统更新后出现模组失效。有关物理系统的完整说明与使用教程，请查阅网易的自定义物理系统。
质量与惯性
- 新增
SetMass、GetMass服务端接口，用于设置与获取刚体的质量，以进行更精细的物理模拟。 - 新增
SetCMassLocalPose服务端接口，用于设置质心的局部位置。 - 新增
GetMassSpaceInertiaTensor服务端接口，用于获取质量空间的惯性张量。
速度与阻尼
- 新增
SetLinearVelocity、GetLinearVelocity、SetAngularVelocity、GetAngularVelocity服务端接口，用于设置与获取刚体的线速度与角速度。 - 新增
SetMaxLinearVelocity、SetMaxAngularVelocity服务端接口，用于限制刚体的最大线速度与最大角速度。其中maxVel必须为有限正数，否则返回False。 - 新增
SetLinearDamping、SetAngularDamping服务端接口，用于设置刚体的线性阻尼与角阻尼。 - 新增
AddTorqueLocal服务端接口，用于在刚体本地坐标系中添加扭矩。
关节
- 新增 新增了固定、距离、球窝、铰链、滑动五类关节的创建接口，分别为
CreateFixedJoint、CreateDistanceJoint、CreateSphericalJoint、CreateRevoluteJoint和CreatePrismaticJoint服务端接口。配合PhysXJointBreakServerEvent事件，可用于制作门、吊桥、可断裂结构等物理玩法。 - 新增
DestroyJoint、DestroyJointsForEntity、DestroyAllJoints服务端接口，用于分别销毁指定关节、销毁某实体关联的关节与销毁全部关节。 - 新增
SetJointCollisionEnabled服务端接口，用于设置相连刚体之间是否相互碰撞。 - 新增
IsJointBroken服务端接口，用于查询关节的断裂状态。 - 新增
GetRevoluteJointAngle、GetRevoluteJointVelocity服务端接口，用于获取旋转关节的角度与角速度。 - 新增
GetJointFrames服务端接口，用于获取关节两端的本地与世界 frame。 - 新增
SetDistanceJointParams服务端接口，用于设置距离关节的参数。 - 新增
SetSphericalJointLimitCone服务端接口，用于设置球形关节的锥形限制。 - 新增
SetRevoluteJointLimit、SetPrismaticJointLimit服务端接口，用于设置旋转关节的角度限制与滑动关节的行程限制。 - 新增
SetRevoluteJointDrive服务端接口，用于设置旋转关节的电机驱动。
碰撞形状
- 新增
RemoveShape、GetShapeCount、GetShapeInfo、RemoveShapeByUserData服务端接口，用于删除指定碰撞形状、获取碰撞形状数量、获取碰撞形状信息与按userData删除碰撞形状。 - 新增
RemoveShape、AddBoxGeometry、GetShapeCount、GetShapeInfo、RemoveShapeByUserData客户端接口，用于操作客户端本地的碰撞形状。其中AddBoxGeometry用于给客户端本地的自定义刚体增加盒形碰撞体。 - 新增
SetGlobalPose客户端接口，用于设置客户端本地自定义刚体的变换。 - 新增
GetLinearVelocity、GetAngularVelocity客户端接口，用于获取自定义刚体的线速度与角速度。
刚体状态
- 新增
IsSleeping、WakeUp、PutToSleep服务端接口，用于查询刚体的休眠状态、唤醒刚体与令刚体进入休眠。 - 新增
GetRigidBodyFlags、GetRigidDynamicLockFlags服务端接口，用于获取刚体标记与动态刚体的锁定标记。 - 新增
GetActorFlags、IsDefaultPxActor服务端接口，用于获取 Actor 标记与判断是否为默认 PxActor。
场景、浮力与同步
- 新增
SetSceneGravity服务端接口，用于设置指定维度的 PhysX 场景重力。 - 新增
SampleBuoyancy服务端接口，用于采样刚体在水面下的体积与浮力。 - 新增
SetRemoteVisualSync、ClearRemoteVisualSync服务端接口，用于配置与清除远距离物理刚体的视觉同步降帧。
模拟回调与调试
- 新增
PhysXPreSimulateServerEvent、PhysXPostSimulateServerEvent服务端事件，分别在服务端 PhysX 模拟的前后回调。 - 新增
PhysXPreSimulateClientEvent、PhysXPostSimulateClientEvent客户端事件，分别在客户端 PhysX 模拟的前后回调。 - 新增
ConnectPvd、DisconnectPvd服务端接口，用于连接与断开 PhysX Visual Debugger。
调整
- 更改
AddBoxGeometry、AddCapsuleGeometry、AddSphereGeometry、AddBoxTrigger服务端接口，现在支持给已有的自定义刚体动态增加盒形、胶囊形、球形碰撞体与盒形触发器。 - 更改
AddForce服务端接口，明确了不同PxForceMode的输入单位，非法枚举值将返回False。 - 更改
AddTorque服务端接口，运动学刚体调用时返回False，不再传入 PhysX。 - 更改
SetJointBreakForce服务端接口，-1会映射为不可断裂，有限阈值必须为非负有限数。 - 更改
GetJointBreakForce、GetJointType服务端接口，无效或已销毁的关节将返回None；关节类型中增加了4，代表 Prismatic 滑动关节。 - 更改
PhysXJointBreakServerEvent服务端事件，补充了breakForce与breakTorque，并支持4号 Prismatic 类型。
屏幕坐标与世界坐标
由于移动端没有严格意义上的准星，一些需要依赖准星判断的内容此前无法实现。该版本新增了一组坐标转换接口，提供了实现这些内容的基础能力。需要注意，这些接口仅提供基本能力，具体的计算方法需要开发者自行处理，官方暂不封装为现成 API。
- 新增
GetWorldRayFromScreenPoint客户端接口，将屏幕坐标转换为世界射线，返回射线原点（近平面上的点）与单位方向向量。 - 新增
WorldToScreenPoint客户端接口，将世界坐标转换为屏幕坐标，返回屏幕坐标、归一化深度与是否在屏幕可见范围内。 - 新增
GetViewMatrix客户端接口，用于获取视图矩阵，返回GameRenderer每帧缓存的mLastLevelViewMatrix。 - 新增
GetProjectionMatrix客户端接口，用于获取投影矩阵，返回GameRenderer每帧缓存的mLastLevelProjMatrix。 - 新增
GetNearFarPlane客户端接口，用于获取近、远裁剪面的距离。 - 新增
GetAspectRatio客户端接口，用于获取画面的宽高比。
联机大厅
- 新增
GetRoomInfo、GetRoomMeta、SetRoomMeta、GetPlayerRoomId服务端接口，用于获取房间的 ID、人数、房主等信息，以及设置、获取房间元数据，以用于房间间的数据同步。其中GetRoomMeta为异步获取。 - 新增
GetHostPlayerUid、TransferRoomHost、TransferRoomHostByUid服务端接口，用于获取房主的 UID，并将房主转移给指定的在线玩家。 - 新增
KickPlayer、KickPlayerByUid服务端接口，用于自定义踢出提示信息并踢出指定玩家，房主除外。 - 新增
RoomHostChangedServerEvent服务端事件，在房主转移时触发，可用于监听房主变化并作相应处理。
标签查询
- 新增
LookupBlocksByBlockTag服务端与客户端接口，用于根据netease_tags中注册的方块标签名查找该标签下的所有方块。 - 新增
LookupItemsByItemTag服务端与客户端接口，用于根据netease_tags中注册的物品标签名查找该标签下的所有物品。
这两个接口均支持#引用的标签自动展开，同一标签名被多个模组注册时会自动合并去重，未注册的原版标签也可直接查询。其配置方法见上方netease_tags所指向的官方文档。
渲染与贴图
- 新增
SetActorBlockGeometryRotationQuat客户端接口，用于以四元数设置实体方块几何体模型的旋转。 - 新增
GetTextureAtlasUV客户端接口，用于获取方块纹理在atlas.terrain图集中的 UV 坐标位置与尺寸信息。 - 新增
GetIconInfo客户端接口，用于获取物品图标纹理在图集中的 UV 坐标位置与尺寸信息。 - 新增
SpawnDestroyParticleEffect客户端接口，用于在指定位置播放指定方块的破坏爆发粒子效果。 - 更改
CombineBlockPaletteToGeometry、CombineBlockBetweenPosToGeometry、CombineBlockFromPosListToGeometry客户端接口，新增支持自定义方块实体外观、国际版方块外观（minecraft:geometry组件）、花盆、钟、潮涌核心、旗帜、铜箱、铜傀儡像、水方块与火方块。
其他调整
- 更改 由于游戏引擎的原生限制，
clouds.png云层贴图不得使用 1×1 大小，否则会被强制替换为纯白色。请改用其他像素尺寸的云层贴图。