📢 Fast Ref v1.0.2 업데이트 내용

🔧 버그 수정

• CONVERTED 레퍼런스 안정성 개선: 씬에서 변환한 레퍼런스의 데이터 호환성 문제 해결
• 레거시 데이터 호환성: 이전 버전에서 저장된 레이어 정보가 정상적으로 불러와지도록 수정

✨ 기능 개선

• Biped Prop Scale 애니메이션 지원: Prop 노드(무기, 소품 등)의 Scale 애니메이션이 Replace 시에도 완벽하게 복원됩니다
  • 기존에는 BIP 파일이 Scale을 저장하지 않아 손실되던 문제 해결
• 라이센스 인증 안정성 향상: 새로운 V2 인증 시스템 적용
  • 더 정확한 라이센스 검증
  • 네트워크 오류 시 상세한 안내 메시지 제공

🎨 UI 개선

• Merge 시 Namespace 경고 추가: Namespace가 켜진 상태에서 Merge할 때 미리 알려드립니다
  • "⚠️ Namespace가 켜져 있습니다. Merge 후: Character:Bip001 형태가 됩니다"
• Help 메뉴에 사용 가이드 추가: 도움말 > Usage Guide에서 공식 가이드 페이지로 바로 이동
  • 현재 언어 설정에 맞는 가이드 페이지 자동 연결 (한국어/영어/일본어/중국어)
• License 메뉴 개선
  • Offline License 메뉴 추가 (오프라인 환경 지원)
  • Firewall Setup Guide 추가 (회사 방화벽 설정 안내)

-개선 및 최적화 된 UI (26.0119 기준)

기능 개선

• Replace 작업 후 프레임 복원: 작업 완료 후 원래 보던 프레임으로 자동 복원
• Rig Info UI 최적화: 더 빠르고 안정적인 UI 로딩

보안 강화

• FBX Export 파일명 생성 시 Path Traversal 공격 방지 강화
• 숨김 파일 생성 방지 로직 추가

UI 개선

• Rig Info 노드 - 저장 버튼 텍스트 통일 ("설정 저장")
• Rig Info 노드 - BipedPlus 모듈 기본 비활성화 (필요시 수동 활성화)

📦 Rig Data Manager 사용 가이드

🤔 이게 뭔가요?

Rig Data Manager는 캐릭터 리그 파일에 추가 정보를 저장해두는 기능입니다.

한 번 설정해두면 나중에 자동으로 처리되어 작업이 훨씬 편해집니다!

😕 이런 적 있으신가요?

1.Fast-Ref 링크가 더 빨리 되면 좋겠는데

2.내가 지정한 컨트롤러만 애니 복원되면 좋겠는데

3.레퍼런스 추가했는데 Selection Set이 안 불러와지네?

4.Fast-Ref가 자동으로 Export하는데, 내가 원하는 것만 뽑고 싶은데?

5.이 캐릭터는 바디, 무기 2개씩 따로 추출해야 하는데...

✨ 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 Export 설정

FBX 내보낼 때 편하게 하기 위한 설정:

💡 팁: Selection Set을 리그 파일에 저장하면, 어떤 씬에서 열어도 동일하게 Export 가능!

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: Save Module List 선택

저장할 데이터 종류를 선택합니다:

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 Export 설정 추가

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

레퍼런스 교체 시

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

❓ FAQ

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 Export 시스템 대규모 업데이트

프리셋 시스템

• Unity, Unreal, Unreal_Skel, Unreal_Ani 기본 프리셋 제공
• 사용자 프리셋 저장 및 관리 기능
• 프리셋별 세부 옵션 커스터마이징

Selection 기반 Export

• 현재 선택한 오브젝트를 바로 FBX로 추출
• Reference 없이도 사용 가능 (협력 작업 시 유용)
• Selection Set별 개별 FBX 추출 지원
  • INFO 노드에서 Export할 Selection Set 지정
  • 지정된 Set별로 개별 FBX 파일 자동 생성

파일명 패턴 시스템

• {filename}, {namespace}, {auto_index} 등 패턴 지원
• 자동 파일명 생성으로 작업 효율 향상

Batch Export

• 여러 MAX 파일을 한번에 FBX로 추출
• 로그 파일 자동 생성

Selection Set Export/Import

• 선택 세트를 JSON 파일로 저장
• 다른 씬에서 불러오기 가능
• 팀 작업 시 Selection Set 공유 용이

Animation Cleanup

• 불필요한 애니메이션 키 정리
• 타임라인 최적화

🛠️ 개선 사항

Rig Info UI 개선

• 접이식 섹션 UI로 깔끔하게 정리
• Mirror Presets 시스템 추가
• 데이터 관리 UI 개선

안정성 강화

• Bip001 다중 지원
• Custom Attribute 애니메이션 복원 안정성 강화

📥 설치 방법

1. [내 계정] → [내 제품] 이동
2. Fast-Ref 에서 사용 중인 3ds Max 버전에 맞는 파일 다운로드
3. .mzp 파일을 3ds Max에 드래그 앤 드롭
4. 3ds Max 재시작
5. 상단 메뉴 > OS Tools > Fast Ref 실행

🔍 원인

리깅 파일에 테스트 애니메이션이 포함된 채로 배포되는 경우가 다수 발견되었습니다.

✅ 해결

Auto Cleanup Animation (Remove except frame 0) 옵션 추가

레퍼런스 추가 시 리깅 파일 내 애니메이션 키가 존재하면

0프레임을 제외한 모든 키를 자동 삭제

합니다.

• Biped, 일반 Bone 모두 적용
• 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 추출] 기능을 통해 수동으로 진행 가능합니다.