小坤
1d963e8307
12 KiB
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(服务端)，增加容器方块所在维度的参数
::: warning 特别注意 3.7同步微软版本后变更内容较多，以下为官方整理的重要变更，请开发者们注意适配。 :::
- 微软在1.21.50继续修改了部分方块ID，如光源方块、虫蚀类方块等，详见3.7版本物品id变更，请开发者注意适配
- 3.7 版本同步微软后，将会移除假日创作者实验。使用实验性功能的内容可能无法正常运行。开发者可以使用网易组件+Mod API，可以复刻大部分内容
- 极限模式说明：以下接口不能在极限模式使用，同样原版指令也将不会生效，请开发者注意使用场景
SetPlayerGameType设置玩家游戏模式SetGameRulesInfoServer设置游戏规则SetGameDifficulty设置游戏难度SetDefaultGameType设置默认游戏模式
- 原版UI变更：原版界面Json路径有所修改，如果开发者修改原版Json界面，则需要重新调整路径。以下文件具有变更，请开发者注意适配
- ui_common.json
- play_screen.json
- gameplay_common.json
- start_screen.json
- pause_screen.json
- settings_screen.json
- hud_screen.json
- inventory_screen.json
- inventory_screen_pocket.json
- general_section.json
- world_section.json
- controls_section.json
- command_block_screen.json
三、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(客户端)，给自定义刚体添加的碰撞体，与其他碰撞体或原版生物发生碰撞/结束碰撞时触发
-
新增ActorDamageCause，新增MaceSmash类型
-
新增BiomeType，新增pale_garden(苍白花园)类型
-
新增EntityType，新增Creaking(嘎枝)类型
-
新增OpenContainerId，新增DynamicContainer类型
-
新增PxActorFlag，物理实体行为枚举
-
新增PxEventMask，碰撞事件枚举
-
新增PxForceMode，添加力的模式
-
新增PxRigidBodyFlag，自定义刚体行为枚举
-
新增PxRigidDynamicLockFlag，自定义刚体约束枚举
-
新增RenderLayer，补充原版发光方块渲染时的材质类型
- 调整
-
调整AddEffectToEntity(服务端)，持续时间支持浮点型
-
调整CanSee(服务端)，增加angleX、angleY的描述
-
调整SetGameDifficulty(服务端)，极限模式不可修改游戏难度
-
调整SetDefaultGameType(服务端)，极限模式不可修改默认游戏模式
-
调整SetGameRulesInfoServer(服务端)，极限模式不可修改cheat_info部分的游戏规则
-
调整UseItemAttackEntity(服务端)，增加damageFormula参数，可传入计算公式来修改伤害值。
-
调整SetPlayerGameType(服务端)，极限模式不可修改玩家个人游戏模式
-
调整GetNotRenderAtAll(客户端)，新增支持CreateClientEntityByTypeStr创建的客户端实体。
-
调整SetNotRenderAtAll(客户端)，新增支持CreateClientEntityByTypeStr创建的客户端实体。
-
调整ResetActorRender(客户端)，新增支持CreateClientEntityByTypeStr创建的客户端实体。
-
调整多个客户端渲染、模型、材质、动画相关接口，新增支持CreateClientEntityByTypeStr创建的客户端实体。详见官方文档。
-
调整ItemPushInCustomContainerServerEvent(服务端)，增加容器方块所在维度的参数
-
调整ItemPullOutCustomContainerServerEvent(服务端)，增加容器方块所在维度的参数
- 废弃（将在未来不可用）
- 废弃OpenVoiceGui，语言转文字功能已移除