[ CHUI 멜리고 출력검사기 ]

아바타 세팅 다 끝내고 기분 좋게 출력(Export)까지 마쳤는데... 막상 멜리고 프로그램에 넣어보니 제대로 안 움직이거나 에러 창만 뜨면서 작동을 안 한 적 있으시죠?

뭐가 문제인지 "Neutral 클립이 없다", "Null 값이 섞여 있다", "본 이름이 중복됐다" 같은 알 수 없는 에러 메시지만 뜨고, 도대체 어디서부터 어떻게 손을 대야 할지 몰라 막막하고 답답하셨을 겁니다.

그래서 에러의 원인을 딱 집어주고, 고칠 수 있는 건 버튼 하나로 고쳐주도록 만들었습니다!

유니티 초보자분들도 알 수 없는 에러 메시지 보면서 당황할 필요 없이, 이 툴 한 번만 돌리면 깔끔하게 한 방에 아바타를 뽑아낼 수 있습니다.

🛠️ 초간단 사용법 (3단계면 끝납니다)

1. 세팅이 끝난 아바타를 툴 창에 드래그 앤 드롭 합니다.

2. [검사 실행] 버튼을 쿨하게 누릅니다.

3. 빨간색(FAIL)으로 뜬 문제들을 확인하고, 고칠 항목만 체크해 [자동수정]을 누른 뒤 마음 편히 출력합니다. 끝!

💡 답답한 속 뻥 뚫어주는 핵심 기능

• 🔍 깐깐한 필수 항목 자동 검사 출력 직전에 가장 많이 빼먹는 에러 요소들을 툴이 알아서 다 찾아냅니다.
• ✨ 클릭 한 번에 끝내는 '선택형 자동 수정' 문제 발견했다고 일일이 폴더 뒤져가며 고칠 필요 없습니다. 수정할 항목만 체크박스로 고르고 자동 수정하세요. (실수해도 Ctrl+Z로 되돌리기 가능해서 안전합니다.)
• 📑 눈에 쏙 들어오는 신호등 리포트 문제없는 100점짜리(PASS)는 숨겨버리고, 당장 고쳐야 할 치명적 에러(FAIL)와 경고(WARN)부터 맨 위에 정렬해서 띄워줍니다.
• 📦 여러 아바타 동시 검사 씬(Scene)에 있는 아바타든, 폴더에 있는 프리팹이든 가리지 않고 한꺼번에 끌어다 놓고 쫙 검사할 수 있습니다.

📋 구체적으로 뭘 검사해주나요? (실제 검사 항목)

• VRM 컴포넌트 검사: 멜리고 출력의 필수 조건인 VRMBlendShapeProxy가 제대로 들어있는지 확인합니다.
• Neutral 클립 검사: 필수 항목인 Neutral 표정이 빠져있는지 체크합니다.
• 빈칸(Null) 검사: BlendShape 목록에 비어있는(null) 찌꺼기 항목이 섞여 있는지 찾아냅니다.
• 본(Bone) 이름 중복 검사: 뼈대 이름과 똑같은 오브젝트가 중복되어 오작동을 일으키지 않는지 꼼꼼히 잡아냅니다.
• 휴머노이드 매핑 검사: 아바타가 정상적으로 움직이기 위한 '필수 뼈대'와 '추천 뼈대' 연결이 제대로 되어있는지 점검합니다.
• Magica Cloth 켜짐 경고: 깜빡하고 마지카 클로스(물리 엔진)를 안 끄고 구워서 옷이 터지는 대참사를 막기 위해, 켜져 있으면 경고(WARN)를 띄워줍니다.

🪄 버튼 한 번에 해결! (자동 수정 가능 리스트)

발견된 에러 중, 귀찮게 폴더를 뒤적거릴 필요 없이 툴이 알아서 고쳐주는 항목들입니다.

• ✅ Neutral 클립 자동 생성 및 추가: 필수 표정인 Neutral 클립이 없나요? 버튼 한 번 누르면 빈 클립을 바로 뚝딱 생성해서 알맞은 자리에 쏙 넣어줍니다.
• ✅ Null(빈칸) 찌꺼기 자동 청소: BlendShape 배열 중간중간에 비어있는(null) 에러 덩어리들을 찾아내서 한 번에 깔끔하게 지워줍니다.

💡 전체 수정은 물론, 원하는 항목만 하나씩 개별 수정도 가능합니다. 수정 전으로 돌아가고 싶다면 언제든지 Ctrl+Z를 눌러 취소할 수 있으니 안심하고 사용하세요!

🙋‍♂️ 이런 분들의 소중한 멘탈을 지켜드립니다

• 출력은 했는데 자꾸 알 수 없는 오류가 나서 막막하신 분
• "Neutral이 없습니다", "Null 항목이 있습니다" 에러를 봐도 도대체 어딜 어떻게 고쳐야 할지 모르는 유니티 초보자분
• 아바타를 대량으로 찍어내야 해서, 출력 전 일괄 점검이 간절하신 분
• 출력 전 돌다리도 열 번씩 두드려보고 건너야 마음이 편한 완벽주의자분

⚠️ 참고해 주세요

• 멜리고 프로그램용 유니티 에디터(Unity Editor) 전용 보조 툴입니다. (Unity 2023 이상 호환 권장)
• Magica Cloth 관련 문제는 툴이 마음대로 건드리지 않고, 여러분이 직접 끄실 수 있게 '경고'만 확실하게 해드립니다.

출력 직전의 그 묘한 불안함, 이제 CHUI 멜리고 출력검사기에 맡겨두고 마음 편하게 아바타 뽑으세요! 💖