# 3.7
2025.12.31：版本号（V3.7 BE1.21.50）包括Mod PC包，手机测试版启动器，和服务器引擎。
示例Demo：前往此处下载
# 一、更新时间表
- 在2025年12月31日上线3.7第一个Beta版。
- 在2026年1月14日上线3.7第二个Beta版。
- 在2026年1月28日上线3.7稳定版。有以下注意事项:
- 3.7稳定包，会提供RenderDragon渲染龙、Opengl两个包体
- 渲染龙版本仅会在Java经典版中的基岩版（非基岩互通版和手机版）上线，基岩互通版和手机端仍然使用 OpenGL
- 为了确保您的模组、光影等内容后续能够兼容基岩版，您可以通过3.7稳定版渲染龙包进行测试兼容开发
- 在2026年2月1日，全渠道将更新3.7版本玩家包体，玩家将陆续更新到3.7版本，请开发者合理安排更新节奏。
# 二、重要功能更新
物理系统
- 注意：物理系列的接口为实验性内容，在后期版本中可能会存在接口变更、开发环境变更等情况。请各位开发者合理安排开发内容与正式版本，避免后续版本物理系统更新后出现模组失效的情况
- 新增创建物理刚体，开发者可以给实体创建自定义刚体，并给刚体添加力、碰撞盒，设置其位置、四元数旋转等，同时新增支持刚体碰撞盒之间碰撞检测、以及适用于刚体的射线检测
- 物理系统相关教程请见物理的使用指南
PC按键绑定
- 新增自定义手柄按键(GamepadKeyMappings)的注册和获取，同时新增事件支持在按下自定义手柄按键时、自定义手柄按键绑定发生改变时触发
- 新增自定义按键映射(CustomKeyMapping)的注册和获取，同时新增事件支持在玩家按下自定义按键时、自定义按键绑定发生改变时触发
客户端实体
- 对 CreateClientEntityByTypeStr 创建的客户端实体，接口创建的客户端实体进行了优化，对实体使用的一系列渲染、模型、材质、动画等接口，也支持对客户端实体使用
- 新增GetEntitiesAroundForClientEntity(客户端)
- 新增GetEntitiesInSquareAreaForClientEntity(客户端)接口， 用于获取区域内的客户端实体
- 新增SetRotForClientEntity(客户端)， 设置客户端实体头与水平方向的俯仰角度和竖直方向的旋转角度
- 新增SetPosForClientEntity(客户端)， 设置客户端实体位置
新增其他接口
- 新增EntityUseItemToPos(服务端)，模拟实体对某个坐标使用指定物品
- 新增UseItemToEntity(服务端)， 模拟对某个实体使用物品
- 新增GetRecipeByRecipeId(客户端)， 可以根据配方id查询配方内容
接口优化
- AddEffectToEntity(服务端)接口持续时间支持设置浮点型
- UseItemAttackEntity(服务端)接口增加damageFormula参数，可传入计算公式来修改伤害值
- 调整ItemPushInCustomContainerServerEvent(服务端)、ItemPullOutCustomContainerServerEvent(服务端)， 增加容器方块所在维度的参数
微软在1.21.50继续修改了部分方块ID，如光源方块、虫蚀类方块等，详见3.7版本物品id变更，相关链接请参阅基岩版扁平化 (opens new window)，请开发者注意适配
# 三、API更新
- 新增
新增EntityUseItemToPos(服务端)， 模拟实体对某个坐标使用指定物品。
新增UseItemToEntity(服务端)， 模拟对某个实体使用物品。
新增CreatePxActor(服务端)， 给实体创建自定义刚体
新增AddBoxGeometry(服务端)， 给自定义刚体创建盒形碰撞体
新增SetRigidBodyFlag(服务端)， 设置自定义刚体的行为
新增SetRigidDynamicLockFlags(服务端)， 设置自定义刚体的约束
新增SetActorFlag(服务端)， 设置物理实体的行为开关
新增SetKinematicTarget(服务端)， 设置运动学刚体的目标变换
新增SetGlobalPose(服务端)， 设置自定义刚体的变换（直接瞬移）
新增AddForce(服务端)， 给自定义刚体添加力
新增GetQuaternion(服务端)， 获取自定义刚体的四元数旋转
新增Raycast(服务端)， 射线检测
新增GetRecipeByRecipeId(服务端)， 根据配方id查询配方内容。
新增GetEntitiesAroundForClientEntity(客户端)， 获取区域内的客户端实体列表
新增GetEntitiesInSquareAreaForClientEntity(客户端)， 获取区域内的客户端实体列表
新增GetQuaternion(客户端)， 获取自定义刚体的四元数旋转
新增Raycast(客户端)， 射线检测
新增GetKeyMappings(客户端)， 获取指定的自定义按键映射配置
新增RegisterCustomKeyMapping(客户端)， 注册自定义按键映射
新增GetGamepadKeyMappings(客户端)， 获取自定义手柄按键映射
新增RegisterCustomGamepadMapping(客户端)， 注册自定义手柄按键映射
新增SetPosForClientEntity(客户端)， 设置客户端实体位置。
新增GetRecipeByRecipeId(客户端)， 根据配方id查询配方内容。
新增SetRotForClientEntity(客户端)， 设置客户端实体头与水平方向的俯仰角度和竖直方向的旋转角度。
新增PhysxTouchServerEvent(服务端)， 给自定义刚体添加的碰撞体，与其他碰撞体或原版生物发生碰撞/结束碰撞时触发
新增OnCustomKeyPressInGame(客户端)， 当玩家按下自定义按键时触发
新增OnCustomKeyChangedEvent(客户端)， 当自定义按键绑定发生改变时触发
新增OnCustomGamepadPressInGame(客户端)， 当玩家按下自定义手柄按键时触发
新增OnCustomGamepadChangedEvent(客户端)， 当自定义手柄按键绑定发生改变时触发
新增PhysxTouchClientEvent(客户端)， 给自定义刚体添加的碰撞体，与其他碰撞体或原版生物发生碰撞/结束碰撞时触发
新增PxActorFlag， 物理实体行为枚举
新增PxEventMask， 碰撞事件枚举
新增PxForceMode， 添加力的模式
新增PxRigidBodyFlag， 自定义刚体行为枚举
新增PxRigidDynamicLockFlag， 自定义刚体约束枚举
新增RenderLayer， 补充原版发光方块渲染时的材质类型
- 调整
调整AddEffectToEntity(服务端)， 持续时间支持浮点型
调整CanSee(服务端)， 增加angleX、angleY的描述
调整SetGameDifficulty(服务端)， 极限模式不可修改游戏难度
调整SetDefaultGameType(服务端)， 极限模式不可修改默认游戏模式
调整SetGameRulesInfoServer(服务端)， 极限模式不可修改cheat_info部分的游戏规则
调整UseItemAttackEntity(服务端)， 增加damageFormula参数，可传入计算公式来修改伤害值。
调整SetPlayerGameType(服务端)， 极限模式不可修改玩家个人游戏模式
调整GetNotRenderAtAll(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整SetNotRenderAtAll(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整ResetActorRender(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整AddActorAnimationController(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整AddAnimationControllerToOneActor(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整RemoveActorAnimationController(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整RemoveAnimationControllerForOneActor(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整AddActorRenderMaterial(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整AddRenderMaterialToOneActor(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整CopyActorRenderMaterialFromPlayer(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整CopyPlayerRenderMaterialToOneActor(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整AddActorRenderController(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整AddRenderControllerToOneActor(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整RemoveActorRenderController(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整RemoveRenderControllerForOneActor(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整AddActorGeometry(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整AddGeometryToOneActor(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整CopyActorGeometryFromPlayer(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整CopyPlayerGeometryToOneActor(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整RebuildRenderForOneActor(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整ResetRenderForOneActor(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整RemoveActorGeometry(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整RemoveGeometryForOneActor(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整AddActorTexture(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整AddTextureToOneActor(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整CopyActorTextureFromPlayer(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整CopyPlayerTextureToOneActor(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整RemoveActorTexture(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整RemoveTextureForOneActor(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整RebuildActorRender(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整AddActorParticleEffect(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整AddParticleEffectToOneActor(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整AddActorSoundEffect(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整AddSoundEffectToOneActor(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整AddActorScriptAnimate(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整AddScriptAnimateToOneActor(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整GetActorRenderParams(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整AddActorAnimation(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整AddAnimationToOneActor(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整AddActorRenderControllerArray(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整AddActorBlockGeometry(客户端)， 新增rotateFirst参数。新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整DeleteActorBlockGeometry(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整ClearActorBlockGeometry(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整SetActorBlockGeometryVisible(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整SetActorAllBlockGeometryVisible(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整SetActorBlockGeometryOffset(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整SetActorBlockGeometryRotation(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整EnableActorBlockGeometryTransparent(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整SetActorBlockGeometryTransparency(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整SetEntityExtraUniforms(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整GetEntityExtraUniforms(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整SetActorBlockGeometryScale(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整GetActorBlockGeometryScale(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整isEntityInLava(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整GetEngineTypeStr(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整HasEntity(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整GetCurrentAirSupply(客户端)， 调整描述，新增备注说明
调整GetMaxAirSupply(客户端)， 调整描述，新增备注说明
调整CanSee(客户端)， 增加angleX、angleY的描述；新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整GetPos(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整GetFootPos(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整GetMolangValue(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整GetRot(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整GetBodyRot(客户端)， 新增支持CreateClientEntityByTypeStr创建的客户端实体。
调整ItemPushInCustomContainerServerEvent(服务端)， 增加容器方块所在维度的参数
调整ItemPullOutCustomContainerServerEvent(服务端)， 增加容器方块所在维度的参数
- 废弃（将在未来不可用）
- 废弃OpenVoiceGui，语言转文字功能已移除
← WalkState Apollo更新信息 →