3dsMax丢失贴图全盘搜索、重连、打包与统一路径

`3dsMax贴图搜索重连打包与统一路径_v1.4.ms` 是一个不依赖第三方库的 MaxScript 工具。

它可以搜索和重连丢失贴图、打包场景贴图，并把场景中全部贴图统一链接到指定文件夹。

## 使用方法

1.扫描丢失贴图

2.搜索文件夹（上方选择要搜索贴图的文件夹,全盘搜索都可以）

3.重连找到的贴图

4.打包全部贴图到MAX同目录

5.全部贴图改到指定文件夹（保存打包好的文件夹）

## 打包场景贴图

1. 先保存当前 `.max` 场景。

2. 点击 **打包场景全部贴图**。

3. 工具会在 MAX 场景同级目录创建名为 `贴图` 的文件夹。

4. 场景中当前能够找到的全部贴图会被复制到该文件夹。

打包功能只复制贴图，不会修改场景内的原贴图路径。已经存在且文件大小、修改时间相同的贴图会跳过；遇到同名但内容不同的文件时，会自动在文件名后添加 `_2`、`_3` 等序号，避免覆盖。

## 将全部贴图统一链接到指定文件夹

1. 点击 **5. 将场景全部贴图统一链接到指定文件夹**。

2. 选择打包好的 `贴图` 文件夹，或者其他贴图总目录。

3. 工具会递归搜索该文件夹及全部子文件夹。

4. 按完整文件名匹配后，把场景内全部贴图路径改为找到的新路径。

5. 检查材质和渲染效果，确认无误后保存场景。

这项功能不仅处理丢失贴图，也会修改当前能够正常找到、但仍指向其他零散目录的贴图。操作前会再次确认，并放在一个 Undo 记录中，可按 **Ctrl+Z** 撤销。目标目录没有同名文件的贴图不会被修改。

也可以直接把 `.ms` 文件拖进 3ds Max 视口运行。

## 匹配规则

- 只处理当前路径不存在的贴图，不会改动正常贴图。

- 按完整文件名匹配，不区分大小写，例如 `Wood_01.JPG` 可以匹配 `wood_01.jpg`。

- 会搜索所选目录的所有子目录。

- 同名文件有多个时，优先选择与原路径末尾目录结构最接近的文件；仍相同时选择目录更浅的文件。

- 支持常见格式：BMP、DDS、EXR、GIF、HDR、IFL、JPG/JPEG、PNG、PSD、RLA/RPF、SGI、TGA、TIF/TIFF、TX、VRIMG、WEBP。

- 支持标准 `BitmapTexture`，并尝试处理常见第三方贴图节点的 `filename`、`file`、`hdrifilename` 等属性。

## 安全与注意事项

- 重连操作被放在一个 Undo 记录中，可用 **Ctrl+Z** 撤销。

- 工具不会自动保存场景；确认无误后请手动保存。

- 工具仅负责贴图文件。代理、IES、缓存、XRef 等其他外部资产不在本版本处理范围内。

- 非标准渲染器如果使用了特殊的文件属性名称，工具会把它显示为未扫描到；可在脚本的 `candidateProperties` 数组中补充属性名。

- 超大型素材库首次索引可能需要一些时间。

## 如果显示 0 个

- “丢失贴图路径为 0”表示 3ds Max 判断当前场景中的贴图都能通过原路径或贴图搜索路径找到。搜索文件夹里有文件，并不代表场景里存在需要重连的丢失引用。

- “资产跟踪中没有识别到贴图”时，请确认已经打开正确的 `.max` 场景，并且场景材质已正常加载。

- “文件夹中索引到 0 个贴图”时，请检查选择的文件夹、Windows 读取权限和贴图扩展名。

- 按 **F11** 可打开 MAXScript 侦听器；如界面提示扫描失败，可查看其中的红色错误信息。

## 建议测试

先在场景副本上运行，并重点检查：

- UDIM 或序列贴图；

- 同名但内容不同的贴图；

- Corona、V-Ray、Arnold 等第三方节点；

- 网络路径和无权限访问的目录。