​
物理引擎

​
调试渲染

​
射线追踪

勾选后，系统将以自身头部为起点、瞄准方向延伸 1000 米为终点，执行一次 Raycast 射线追踪，用于检测是否命中障碍物。命中结果将通过渲染方式显示：起点、命中点与目标点将以线段连接直观呈现。

​
静态模型

启用后，将渲染物理引擎中已加载的静态模型对象。

​
动态模型

启用后，将渲染物理引擎中已加载的动态模型对象。

​
地形

启用后，将渲染物理引擎中已加载的地形数据。

​
渲染距离

设置调试渲染功能的最大显示距离。建议保持较低数值，以减少系统负载，避免卡顿、掉帧或程序崩溃。
上述功能仅用于测试与调试场景。正常使用过程中请勿勾选，否则将严重影响视觉渲染帧率。

​
通用设置

​
静态模型加载半径

设置静态模型加载范围（以自身为圆心的半径），建议根据设备性能合理调整。数值过高可能引起性能下降、卡顿或崩溃，数值过低则可能影响体验。

​
动态模型加载半径

设置动态模型加载范围，同样需结合自身硬件性能进行调节。

​
物理模型类型

  • 描述：
在识别到场景信息后，直接加载预烘焙好的模型数据，无需额外解析。
  • 优点：
加载速度极快，占用资源少。 对副机性能要求低，适合资源有限的设备。
  • 缺点：
不支持门板、部分铁栅栏等交互式物体。 不支持场景破坏（如倒塌建筑、破坏物体）。 对于被破坏的场景无法实时更新，易造成物理误判。
  • 描述：
在加载预烘焙模型的基础上，支持实时读取、烘焙和加载未缓存的模型数据。
  • 优点：
性能与兼容性较好。
支持交互式物体（如门、铁栅栏等）。
射线检测精度较静态模型更高。
  • 缺点：
需要一定的 副机处理能力 和 高 DMA 传输速率。
实时加载可能在低性能设备上造成轻微卡顿。
  • 描述：
综合静态与动态模型方式。优先加载预烘焙模型，缺失部分实时读取；场景加载后进行数据对比与更新。
  • 优点：
支持卡拉金、萨诺等地图的场景动态破坏。
兼容帕拉莫地图中随机生成建筑结构。
  • 缺点：
性能消耗大，效率低于其他两种方式。
对副机性能和 DMA 带宽要求极高。
在特定场景下可能导致闪退、加载失败、模型不一致等问题。
所有模型加载方式 均不支持地形破坏。 若出现模型异常或场景错误，请按照以下步骤尝试恢复：
  1. 打开菜单中的 物理引擎 页面；
  2. 点击 清理缓存文件 按钮；
  3. 然后按下 F8（默认快捷键）以重新构建物理场景；
  4. 如问题仍未解决，建议切换至 静态模型 或 动态模型 模式进行排查。

​
清理缓存文件

当模型表现异常（如 Raycast 持续命中异常位置、控制台输出 unknown mesh 等提示）时，点击此按钮清理相关缓存文件，恢复模型正常显示。

​
重载场景

点击后将重新建立当前物理场景，适用于解决部分模型加载异常问题。若模型缓存受损，建议 先点击“清理缓存文件”，再使用此功能以确保重载生效。