Fast Ref
/
FAQ
[FAQ] 如何使用公司内部自定义导出工具？
Fast-Ref 基本上旨在通过其内置功能优化游戏引擎的 FBX 导出。但我们充分理解每个工作室都有各自独特的管线和定制需求。
Fast-Ref 中的所有组件都基于 3ds Max 标准节点设计。因此，只要您在导出后不保存场景文件，即可自由编辑数据结构并与内部工具集成。
⚠️ 最重要原则：导出操作后绝对不要保存场景。
Fast-Ref 的引用系统数据将会丢失，导致无法正常管理。
1. Reset All References 功能（v1.0.4+）
使用 v1.0.4 起提供的 Reset All References 功能，所有引用都会被转换为普通场景对象，可以在不受 Fast-Ref 链接影响的情况下自由操作。
路径：Tools → Edit → Reset All References (Merge All)
此功能会自动执行以下操作：
- 清理所有命名空间和后缀
- 解除层级结构（Hierarchy）
- 扁平化图层结构
- 移除 Fast-Ref 系统数据
当需要临时与内部导出工具集成时，先执行此功能再进行导出即可。
⚠️ 再次强调：Reset 后不要保存场景。只需进行导出即可，无需保存。
Merge All Options（可在 General Options 中配置）
运行 Reset All References 时应用的后缀清理选项可在 General Options 对话框中更改。
路径：Tools → General Options → Merge All Options
| 选项 | 默认值 | 说明 | 默认值说明 |
|---|---|---|---|
| Force Remove Node Suffix (.r*) | ✅ ON | 从节点名称中移除 .r1、.r2 后缀 | 游戏引擎基于节点名称映射骨骼/网格，留有后缀可能导致重定向和脚本引用失效 |
| Force Remove Layer Suffix (.r*) | ⬜ OFF | 从图层名称中移除后缀（存在同名时自动合并） | 当同一资源被多次放置时，可能发生意外的图层合并，出于安全考虑默认为 OFF |
| Force Remove SelectionSet Suffix (.r*) | ✅ ON | 从 SelectionSet 名称中移除后缀（存在同名时自动合并） | Export 脚本通常通过 SelectionSet 名称指定分组，留有后缀可能导致兼容性问题 |
2. Script API 支持（计划中）
为满足更高级自动化需求，我们计划提供 Fast-Ref Script API。内部 TA 可以通过 Python 脚本自动执行引用查询、添加、移除、Merge 等操作。
from os_fast_ref.api import FastRefAPI
api = FastRefAPI()
# 현재 레퍼런스 조회
refs = api.get_reference_list()
# 전체 Merge (Reset All과 동일)
api.merge_all_references()API 详细文档将另行提供，如有需要请联系我们。
3. 手动编辑参考事项
如果您选择不使用 API 或 Reset 功能而直接编写脚本进行编辑，请参考以下规则。
- 命名空间移除：删除 : 符号前的字符串。（例如：Mable:Root.r1 → Root.r1）
- 后缀移除：删除 .r* 格式的后缀。（例如：Root.r1 → Root）
- 层级解除：对以 [REF] 开头的节点的子节点执行 Unparent 操作。
- 图层清理：将 [REF] 前缀图层下的子图层移至顶层，然后删除 [REF] 图层。
💡 最推荐的方法
最高效的集成方法是将您工作室的内部导出环境和需求分享给我们。在我们直接提供指导的过程中，往往能找到出乎意料的更简单的解决方案。
如果在结构分析或集成过程中需要技术支持，请随时通过以下联系方式与我们联系。
OtakuSolutions 积极支持您构建灵活的管线。