资源检查器

资源检查器 帮助检查当前加载关卡中使用的资源和材质。当关卡中出现贴图丢失、材质重复、文件体积异常、未被使用的资源、或者静态网格碰撞数据过多时，可以使用此工具进行排查。

工具分为三个主要区域：

• 材质验证：检查材质定义和贴图引用情况。
• 资源浏览器：列出已加载和未被使用的关卡资源。
• 资源统计：汇总资源大小及场景对象数量。

可以通过世界编辑器窗口菜单中的 资源检查器 打开该工具。

材质验证

材质验证 标签页会检查当前关卡使用到的材质文件。如果已加载玩家载具，该标签页可以在当前关卡和当前载具间切换检查。正在检查： 后面的路径会显示下一步操作要检查的内容根目录。

在导入美术资源、迁移材质、更改贴图位置或升级旧关卡内容后，这个标签页尤其有用。

可用的检查包括：

• 检查材质版本：查找需要更新为当前材质格式的旧材质定义。
• 验证重复项：查找同一材质被定义多次的情况。材质重复可能导致编辑时加载来源不明确。
• 移除 pid：从材质数据移除已弃用的持久化 ID（Persistent IDs）。
• 转换为 PNG：将旧的 DDS 贴图引用通过选定输出文件夹转为 PNG。
• 检查贴图映射：校验材质插槽中使用的贴图路径，报告丢失或错误引用的文件。
• 检查贴图文件：检查贴图格式、尺寸是否为 2 的幂，以及贴图烘焙相关问题。
• 检查材质缺失：检查当前加载模型中缺失的材质映射。
• 移除虚假材质：在检测载具数据时，从载具中移除无用的虚假材质。

当你希望在查找重复项时忽略共享的公共资源时，可以启用 跳过常用文件夹 选项。

结果列表可能包含文件名、材质名称、贴图插槽及问题计数。你可以选择条目以检查详细信息，如需手动修复材质可使用材质编辑器。

资源浏览器

资源浏览器 标签页会生成当前关卡所用资源的列表。当你需要了解场景中实际加载了哪些资源，或怀疑某些文件已经没有被引用时，这里是首选入口。

• 已加载 TSStatics：列出当前加载的 TSStatic 对象及其网格使用情况。
• 可用 ForestItems：列出可用的森林网格资源。
• 已加载地形：列出地形块及其尺寸信息。
• 已用材质：列出当前关卡所用到的所有材质。
• 未用材质：查找未被使用的材质定义。
• 未用网格：查找未被引用的网格文件。
• 未用贴图：查找未被使用的贴图文件。
• 碰撞数据：汇总静态网格碰撞使用情况以及可见网格碰撞统计。

部分检查结果可以在列表中选择、预览或移除。注意，移除文件是不可逆操作，且仅对未打包内容有效，因此在进行删除前请务必备份你的工作。

未使用资源检查旨在作为清理辅助工具，而不是完全取代人工审核。在删除文件之前，请确认该资源是否被预制件、任务、流程图、可选变体或其他当前未被关卡加载的内容所引用。

使用 碰撞数据 可以帮助识别昂贵的静态碰撞使用情况。如果某个资源的可见网格碰撞数量很大，通常说明该资源应采用更简单的碰撞网格。

资源统计

资源统计 标签页会扫描关卡，并按类别汇总磁盘占用。点击 扫描资源 可生成报告。如果已加载玩家载具，标签页可在扫描当前关卡与当前载具之间切换。

概览内容包括：

• 贴图、网格、地形、音频、数据块及其他资源的磁盘占用。
• 贴图与网格的使用空间占比。
• 各类场景对象数量，包括 TSStatic、森林元素、地形、道路、灯光和声音对象。

概览页还显示了各类资源的彩色磁盘使用分布。将鼠标悬停在类别条上可显示每个类别体积最大的文件。

详细视图提供了按文件夹分层和类似树状图的磁盘占用明细。你可以用它查找最大体积的单个文件、异常重复的文件夹，或主导关卡容量的资源类别。

结果解读

检查完成后，工具会报告任务执行情况，并显示结果列表。部分列表支持上下文操作：

• 左键点击行可选中或查看详细条目。
• 在支持的情况下，右键可打开上下文菜单。
• 对贴图文件可使用图片预览功能。
• 仅在确认文件确实未被使用后，再执行移除操作。

如结果显示任务失败，请查看游戏日志以获取详细错误信息，并在修复缺失文件或无效路径后重新运行检查。

典型工作流程

1. 在世界编辑器中加载关卡。
2. 运行 资源统计，了解占用空间较大的主要资源。
3. 使用 资源浏览器，查找未使用的网格、贴图、材质及碰撞资源。
4. 使用 材质校验，修复材质和贴图相关问题。
5. 在资源浏览器或材质编辑器中打开相关资源并进行必要修改。
6. 修改后重新运行相关检查。

相关工具

• 资源去重工具
• 关卡校验器