# Ep.9 — Batch Tool (일괄 Reload 및 FBX 자동 익스포터)

https://youtu.be/sCv6kRaUKSk?si=bh_bYs64miCM9jRz

> **한 줄 요약**: 수십 개의 애니메이션 맥스 파일을 하나씩 열고, 갱신된 리그를 적용하고, 캐릭터별로 FBX를 다시 뽑는 가혹한 단순 노가다를 단 한 번의 배치 설정으로 자동화(Batch)해 주는 야간 작업 특화 생산성 부스터입니다.

---

## 1. Batch Tool의 실무 가치 체감하기

예를 들어 다음과 같은 상황이 있습니다.
> **"한 씬에 달리기 동작을 수행하는 캐릭터 3명이 등장합니다. 이런 씬이 총 3개(3개의 시네마틱 컷) 존재합니다."**

리그 파일이 v2로 업데이트되었을 때, 이 3개의 씬에 대해 아티스트가 직접 업데이트하고 익스포트해야 하는 횟수는 총 **9번(3 캐릭터 x 3개 파일)** 입니다.
만약 파일이 20개, 캐릭터가 5명이라면 100번이 넘는 수작업이 강제됩니다.
Fast-Ref의 **Batch Tool**은 아티스트가 퇴근하기 전 이 100여 개의 수동 공정을 단 한 번의 버튼 클릭으로 밤새 알아서 컴퓨터가 일하도록 세팅하는 궁극의 배치 처리 자동화 창입니다.

---

## 2. 배치 툴 진입 및 구성

메인 Fast-Ref 윈도우의 **Tool -> Batch Tool** 메뉴를 클릭하면 독립적인 배치 제어용 대형 다이얼로그 창이 전개됩니다.
(메인 Fast-Ref 시스템에 내장되어 단일 라이센스로 무상 통합 제공됩니다.)

---

## 3. 핵심 자동화 기능 (양대 축)

배치 프로세서는 아래의 두 단계를 순차적으로, 혹은 개별적으로 완벽히 오토메이션 처리합니다.

### 🔄 1. Reload (일괄 레퍼런스 업데이트)
- 등록된 목록 안의 각 max 파일을 차례로 조용히 엽니다.
- Fast-Ref 분석기(Engine)를 가동해, 해당 씬 내부의 어떤 캐릭터 리그가 디스크의 최신 버전(노란색 알림 등) 상태보다 구버전인지 감지합니다.
- 자동으로 최신 리그로 리로드(Reload)하여 연결 구조와 신형 뼈대, 스킨을 반영합니다.

### 📤 2. Export FBX (일괄 엔진용 배포 추출)
- 리로드가 성공적으로 끝난 캐릭터의 뼈대와 애니메이션을 읽어들입니다.
- EP08에서 미리 세팅해 둔 글로벌 FBX 프리셋 규칙(네임스페이스 제거, 스킨 Off 여부, 루트 원점 동결 등)을 호출합니다.
- 각 파일별, 혹은 파일 내 캐릭터 슬롯별로 고유한 FBX 파일을 씬 외부 폴더로 일괄 쏟아내 줍니다.

---

## 4. 안전한 배치 실행 세부 셋업 가이드

배치를 처음 돌릴 때 원본 파일 훼손이 걱정된다면 아래의 안전장치 세팅을 확인하세요.

- **Reload 씬 저장 경로 분기**:
  - **Overwrite**: 갱신된 최신 리그 상태를 원본 작업 파일 위에 그대로 덮어씁니다. (파이프라인이 완전 안정화되었을 때 사용)
  - **Custom Path**: 원본은 절대 건드리지 않고, 지정한 별도 백업 디렉터리(`D:/FR_Backup/` 등) 안에 리로드 완료된 새 `.max` 파일을 복제해 모아줍니다. (초기 검증 및 강력 추천 옵션)
- **FBX 아웃풋 경로 지정**: 최종 게임 엔진 리소스 폴더(Content/Character 등)의 타겟 경로를 정해 두면, 배치 성공 즉시 엔진 측에 갱신된 데이터가 한 번에 꽂힙니다.

---

## 5. 결과 확인 및 상세 디버깅 로그

배치가 백그라운드로 밤새 구동되는 와중에 오류가 발생한 파일이 있는지 확인하는 기능입니다.
- 배치가 모두 완료되면, 완료된 슬롯들은 화사한 **🟢 녹색 박스**로 시각적 패스를 안내해 줍니다.
- 에러가 나거나 Skip된 파일이 있다면, 배치 창 하단의 **Open Folder** 버튼을 눌러 로그 디렉터리를 엽니다.
- 자동으로 생성된 상세 로그 텍스트를 메모장으로 열어 보면, 어느 씬의 몇 번째 프레임에서 오류가 났는지, 어떤 데이터가 누락되었는지를 직관적인 텍스트로 트래킹할 수 있어 교정이 매우 빠릅니다.

---

## 💡 실무자의 시선: "우리가 자체 툴을 만들지 않는 이유"

큰 규모의 스튜디오들은 대개 인하우스 TA팀이 엄청난 공수를 들여 자체적인 대량 배치 툴을 만듭니다. 하지만 유지 보수가 어렵고 맥스 신 버전 호환 시 매번 에러를 뿜기 일쑤입니다.
Fast-Ref의 배치 툴은 이미 언리얼/유니티 연동 안정성, 백그라운드 리로드 무실패 구조가 수많은 프로덕션에서 수만 장의 파일로 검증된 기성품 엔진이므로, 스튜디오에 태우는 순간 개발팀 전체의 파일 배포 리드가 비약적으로 축소됩니다.

---

## 📞 사용자 지원 및 피드백 채널
작동 도중 특수한 커스텀 컨트롤러 셋업 때문에 본 배치가 스킵되거나 예상과 다르게 꼬이는 파일이 발견되면, 지체 없이 **오타쿠솔루션즈 테크니컬 서포트 팀 공식 이메일**로 원본 씬과 증상을 보내주세요. 실무 담당 TA가 면밀히 분석하여 신속하게 핫픽스를 제공해 드립니다.