📢 Fast Ref v1.0.2 更新内容

🔧 错误修复

• 改进 CONVERTED 参照稳定性：解决场景中已转换参照的数据兼容性问题
• 旧版数据兼容性：修复旧版本中保存的图层信息无法正常加载的问题

✨ 功能改进

• 支持 Biped Prop Scale 动画：Prop 节点（武器、道具等）的 Scale 动画在 Replace 时也能完美恢复
• 提升许可证验证稳定性：采用新的 V2 认证系统

🎨 UI 改进

• Merge 时新增 Namespace 警告：在 Namespace 开启状态下执行 Merge 时提前告知
• 在 Help 菜单中添加使用指南：从帮助 > 使用指南直接跳转至官方指南页面
• License 菜单改进

-改进和优化的 UI（以 26.0119 为基准）

功能改进

• Replace 操作后的帧恢复：操作完成后自动恢复到原先查看的帧
• Rig Info UI 优化：更快、更稳定的 UI 加载

安全性增强

• 强化生成 FBX 导出文件名时对路径遍历攻击的防护
• 新增防止创建隐藏文件的逻辑

UI 改进

• Rig Info 节点 - 统一保存按钮文字（"保存设置"）
• Rig Info 节点 - BipedPlus 模块默认禁用（需要时手动启用）

📦 Rig Data Manager 使用指南

🤔 这是什么？

Rig Data Manager 是一个将额外信息保存到角色绑定文件中的功能。

一旦设置好，后续将自动处理，工作效率大幅提升！

😕 您有过这样的经历吗？

1. 希望 Fast-Ref 链接速度能更快

2. 希望只恢复我指定的控制器的动画

3. 添加参照后，Selection Set 没有加载进来？

4. Fast-Ref 会自动导出，但我只想导出我需要的内容？

5. 这个角色需要分别导出身体和武器各两个...

✨ Rig Data Manager 帮您解决！

设置一次 → 持续轻松使用！

🧩 Fast-Ref / FBX / BipedPlus 是什么？

Rig Data Manager 是 OtakuSolutions 各产品共享的集成信息节点。

由于每个产品需要的信息不同，因此按模块进行了分离：

💡 只勾选您使用的产品！

예시 1) Fast-Ref만 사용하는 경우
   ☑️ Fast-Ref  ☐ FBX  ☐ BipedPlus

예시 2) Fast-Ref + FBX Export 사용하는 경우
   ☑️ Fast-Ref  ☑️ FBX  ☐ BipedPlus

예시 3) 모든 기능 사용하는 경우
   ☑️ Fast-Ref  ☑️ FBX  ☑️ BipedPlus

⚠️ 不使用的产品无需勾选！
只保存需要的内容即可。

📋 各模块保存的内容

1️⃣ Fast-Ref（基本）

替换参照时自动恢复所需的信息：

2️⃣ FBX 导出设置

为方便 FBX 导出而进行的设置：

💡 提示：将 Selection Set 保存在绑定文件中，无论在哪个场景打开，都能以相同方式导出！

3️⃣ BipedPlus（可选）

如果您使用 Reset/Mirror 功能：

📖 参考：有关初始姿势保存和镜像设置的详细信息，请参阅 BipedPlus 使用指南中的单独说明。

🎮 使用方法

Step 1: 打开 Rig Data Manager

Fast-Ref 메인 UI → Tools 메뉴 → Rig Data Manager

Step 2: 确认目标信息

• 当前文件：已打开的 .max 文件名
• InfoNode：INFO 节点是否存在

Step 3: 验证清单

保存前检查可能存在问题的项目：

⚠️ 注意：绑定必须在 T-Pose 或默认姿势状态下保存！

Step 4: Controller List 管理

注册非 Biped 的普通控制器节点：

Step 5: 选择保存模块列表

选择要保存的数据类型：

Step 6: 保存

• INFO 更新 / 保存（🟢 绿色）：保存到 INFO 节点
• INFO 读取（🔵 蓝色）：加载现有数据
• INFO 删除：删除 INFO 节点

💡 推荐工作流程

完成绑定后的首次保存

1. 리그 작업 완료 (T-Pose 상태)
2. Rig Data Manager 열기
3. Controller List에 컨트롤러 추가 (자동 감지 또는 수동)
4. Fast-Ref 체크
5. INFO 업데이트 / 저장 클릭
6. .max 파일 저장

添加 FBX 导出设置

1. Rig Data Manager 열기
2. FBX 탭 클릭
3. Export Mode: Defined 선택
4. Export할 Selection Set 체크
5. FBX 저장 클릭

替换参照时

INFO 노드 데이터를 기반으로:
- Biped 애니메이션 자동 복원
- 컨트롤러 컨스트레인 자동 복원
- 커스텀 본 애니메이션 자동 복원

❓ 常见问题

Q：INFO 节点在哪里创建？

A：在场景的最顶层创建，命名为 __INFO__REFERENCE。以 Point Helper 形式存在，不影响渲染。

Q：删除 INFO 节点会怎样？

A：自动分析模式将被激活，基本功能正常运行。但预先保存的设置（Selection Set 等）将无法使用。

Q：有多个角色时怎么办？

A：打开每个角色的绑定文件（.max），分别保存 INFO 节点即可。

Q：没有 BipedPlus 也能使用吗？

A：是的，当然可以！只需勾选 Fast-Ref 并保存即可。BipedPlus 数据是可选的。

Q：UI 使用起来有些不便，有改进计划吗？

A：是的，截至 2026.01.19，UI 已经有所改进，下一个版本将进一步提升便利性。即使当前版本使用不便，也请稍作等待。🙏 将比现在有所改进，目前虽然繁琐，请使用现有 UI，我们承诺在下一个版本中进行改进！

-改进和优化的 UI（以 26.0119 为基准）

🔥 新功能

FBX 导出系统大规模更新

预设系统

• 提供 Unity、Unreal、Unreal_Skel、Unreal_Ani 默认预设
• 用户预设保存与管理功能
• 按预设自定义详细选项

基于选择的导出

• 将当前选中的对象直接导出为 FBX
• 无需参照文件即可使用（适合协作工作）
• 支持按 Selection Set 单独导出 FBX

文件名模式系统

• 支持 {filename}、{namespace}、{auto_index} 等模式
• 通过自动生成文件名提升工作效率

批量导出

• 将多个 MAX 文件一次性导出为 FBX
• 自动生成日志文件

Selection Set 导入/导出

• 将选择集保存为 JSON 文件
• 可在其他场景中加载
• 团队协作时便于共享 Selection Set

动画清理

• 清理不必要的动画关键帧
• 时间轴优化

🛠️ 改进内容

Rig Info UI 改进

• 通过可折叠区域 UI 整洁排列
• 新增 Mirror Presets 系统
• 数据管理 UI 改进

稳定性增强

• 支持多个 Bip001
• 增强自定义属性动画恢复的稳定性

📥 安装方法

1. 前往 [我的账户] → [我的产品]
2. 下载与 Fast-Ref 使用的 3ds Max 版本对应的文件
3. 将 .mzp 文件拖放到 3ds Max 中
4. 重启 3ds Max
5. 从顶部菜单 > OS Tools > Fast Ref 运行

🔍 原因

发现多例绑定文件在包含测试动画的情况下被分发的情况。

✅ 解决

新增 Auto Cleanup Animation（删除第0帧以外的帧）选项

在添加参照文件时，若绑定文件中存在动画关键帧，

除第0帧外的所有关键帧将被自动删除

。

• 适用于 Biped 和普通骨骼
• 可在 Tools > Options > General > Add Process 中设置
• 默认值：启用 (True)

💡 建议

分发绑定文件时，建议在第0帧设置好默认姿势（T-Pose 等）。

• 原因：重新安装 Fast-Ref 时，用户单独设置的 FBX 选项会被重置，造成不便。本次更新对此进行了改进。

• 修复内容：即使重新安装 Fast-Ref，之前保存的 FBX 选项（用户预设）也不会被重置，得以完整保留。

• 更新目的：增强便利性，使您在重新安装后无需繁琐的重新设置即可快速恢复原有工作环境。

1. 背景与原因（Context）

• 引擎注册必要流程：要将角色或资产注册到 Unreal 或 Unity 引擎中，必须导出基本姿势（Base Pose）状态的 FBX 数据。
• 原有方式的限制：现有 Fast-Ref 系统仅基于'项目列表'中已注册的数据运行，导出未注册的临时对象或特定状态数据时较为繁琐。

2. 解决方法（Solution）

• 手动导出功能：功能已调整为更加灵活，用户无需经过项目注册流程即可立即导出所需对象。
• 操作路径：可通过顶部菜单的 [Export] → [导出选中对象为 FBX] 功能手动进行。