쓰고 보니까 이미 아래 글에서 잘 설명해줬네;

나도 아직 잘 모르긴 하지만 쓰면서 알게된 부분에 대해서 얘기해보고자 함

옷장 만들기 AtoZ는 아니고, 옷장의 구조를 안다는 전제 하에 작성했음

혹시나 틀린 부분 있으면 지적 부탁드립니다

모듈러 아바타 튜토리얼 - VRChat 마이너 갤러리

모듈러 아바타 공식홈페이지https://modular-avatar.nadena.dev/ Modular Avatar | Modular AvatarDrag-and-Drop Avatar Assemblymod

gall.dcinside.com

0. 왜 굳이 모듈러를 써야하는데

제일 크게 다가왔던건 옷을 입힐 때 아바타 프리팹, 의상 프리팹 두 개 모두를 박살내지 않아도 된다는 점임

특히 아바타 프리팹을 부수지 않는다는게 얼마나 메리트가 큰가? 에 대해 설명해주고 싶음

나는 1아바타 1의상을 사용하는데, 옷 입히면서 프리팹이 다 깨져버린 상태일 경우엔

바디나 얼굴의 쉐이프키 하나를 바꾸고싶다거나, 가슴 피본값을 바꾸고 싶을때는 여태 만들어둔 아바타들을 싹 다 찾아서 고쳐줘야함

하지만 프리팹이 깨지지 않았을 경우에는 베이스 프리팹 하나만 수정하고, 그 수치를 오버라이드 해주면 그 프리팹을 사용하는 모든 아바타에 그 수치가 적용됨

이렇게 아바타 프리팹을 안 깨트리고 입혀주기만 해도 이미 무지막지하게 편한데, 자체 기능을 통해 옷장도 만들어버릴 수 있음

처음 보면 만들기 번거로워 보일 수도 있는데 한 번 해보면 기존 옷장하고 크게 다르지도 않고

오히려 아바타마다 FX, 메뉴, 파라미터 따로 만들 필요가 없어져서 프로젝트 관리하기가 더 쉬울거라고 생각함

아래는 모듈러 아바타를 사용하지 않고 만든 기존의 옷장의 형태와, 모듈러 옷장을 사용했을 때의 아바타 디스크립터의 차이임 

---

1. 비 모듈러 옷장이 적용된 아바타의 아바타 디스크립터

---

2. 모듈러 옷장이 적용된 아바타의 아바타 디스크립터

얼핏 봐도 일단 베이스 아바타의 구성이 말끔해진 걸 알 수 있음

모듈러는 이 말끔한 베이스를 파괴하지 않고 별도의 오브젝트를 구성하는 것으로 다양한 기능을 구현하는게 핵심임

---

3. 모듈러 옷장 세팅 (Bool 옷장, 1개의 옷 기준)

나는 옷 프리팹 최상위 오브젝트에다가 컴포넌트를 추가했음

이렇게 만들면 옷 프리팹 자체가 하나의 옷장이 되는 형태가 됨

필요한 컴포넌트는 ‘MA Menu Installer’, ‘MA Merge Animator’, ’MA Parameters’, 이 3개임

MA Menu Installer

‘Install To’에 들어간 익스프레션 메뉴에 ‘Menu to Install’에 들어간 익스프레션 메뉴를 설치

‘Install To’에는 아바타 디스크립트에 들어가있는 익스프레션 메뉴를 집어넣으면 되는데, 아바타 하위에 옷을 두면 자동으로 들어가져있음

‘Menu to Install’에는 옷장 메뉴를 넣으면 되고, 깔끔하게 정리하려면 '서브메뉴' - '토글' 식으로 구성해서 '서브메뉴'를 여기 넣어주면 됨

MA Merge Animator

‘Animator to merge’에 들어간 애니메이터를 ‘Layer Type’에 지정한 원본 레이어에 통합

옷장은 FX로 만드니까 FX로 설정하면 됨

‘Path Mode’는 두 가지 옵션이 존재함

상대 경로 모드(Relative...)는 모듈러 아바타 컴포넌트가 적용된 오브젝트의 하위까지만 제어할 수 있음

절대 경로 모드(Absolute...)는 모듈러 아바타 컴포넌트가 적용된 오브젝트를 포함, 상위 오브젝트 전체를 제어할 수 있음

옷을 입히고 벗길 때, 아바타 바디의 쉐이프 키를 조절 해야 하는 경우 상대 경로 모드에서는 할 수 없고, 절대 경로 모드를 사용 해야함

'Match Avatar Write Defaults'에 체크하면, ‘Animator to merge’에 들어간 레이어 내 State의 WD를 원본 레이어의 기본값과 자동으로 통일시켜줌

MA Parameters

기존 옷장에서 아바타 디스크립터 내에 있는 익스프레션 파라미터에 작성했던 파라미터 정보를 여기다가 작성해주면 됨

‘MA Menu Installer’나 ’MA Merge Animator’에서 파라미터가 입력된 상태라면 자동으로 리스트를 가져옴

‘Internal’ 옵션을 활성화 할 경우, 이 파라미터는 해당 모듈러 아바타 오브젝트의 애니메이터에서만 사용할 수 있는 독립된 파라미터가 되고,

해당하는 파라미터는 다른 애니메이터의 파라미터명과 중복이 가능함

(예시)    별도의 프리팹으로 분리된, 상의/하의로 나뉜 ‘A 옷’와 ‘B 옷’를 온/오프 하는 두 개의 옷장을 만들 때,

각 파라미터의 ’Internal’ 옵션을 활성화 할 경우, 두 옷의 상/하의 파라미터를 모두 같은 이름으로 설정하더라도

런타임 시 각 옷장의 독립된 파라미터(상의$$A옷장, 상의$$B옷장)가 되어 옷장 간 파라미터가 충돌하지 않음

이외의 다른 옵션은 기존 익스프레션 파라미터와 동일함

---

4. 그래서 기존 옷장에서 뭘 바꿔야하는데

1. 옷장을 만들고 싶은 옷의 최상위 오브젝트에 ‘MA Menu Installer’, ‘MA Merge Animator’, ’MA Parameters’ 컴포넌트를 추가

2. 기존 옷장의 FX를 복사하고, 아바타 디스크립터에 있는 FX는 기본 레이어(AllParts, Hand, 페이셜(선택) 등) 및 파라미터만 남기고 제거
- 페이셜의 경우에도 모듈러로 만들 수 있으니 응용 가능하다면 시도해보기 바람

3. 반대로 복사한 FX는 옷장을 구성하는 레이어와 파라미터만 남기고 제거
- 복사한 FX는 ‘MA Merge Animator’의 ‘Animator to merge’에 추가

4. 기존 옷장의 메뉴를 복사하고, 아바타 디스크립터에 있는 메뉴는 기본 메뉴만 남기고 제거
- 아바타 디스크립터에 있는 메뉴를 ‘MA Menu Installer’의 ‘Install To’에도 추가

5. 반대로 복사한 메뉴는 옷장을 구성하는 메뉴만 남기고 제거
- 복사한 메뉴는 ‘MA Menu Installer’의 ‘Menu to Install’에 추가

6. 기존 옷장의 파라미터에서 옷장을 구성하는 파라미터를 제거

7. ‘MA Parameters’에 옷장을 구성하는 파라미터 정보를 추가

8. 온오프 애니메이션 추가
- 모듈러 옷과 기존 옷의 경로가 일치할 경우, ‘MA Merge Animator’의 'Path Mode'를 ‘Absolute...’로 설정하면 별도 수정 없이 적용 가능
- 단, 옷 본을 ‘수동 도입’한 상태의 애니메이션일 경우, 본의 온오프는 옷 프리팹 내의 본를 기준으로 다시 녹화해줘야함

---

이외의 사용법은 맨 위에 남겨둔 링크에서 상세히 설명해주고 있으니 읽어보길 바람

---

아래 파일은 모듈러 알아보면서 만들어 본 도라지용 기본 속옷(Kikyo_Bra, Kikyo_Shorts) 온오프 에셋의 예제임

위에서 설명했던 세 가지 컴포넌트를 모두 넣고 만들었음

프리팹을 아바타 하위에 넣고 제스처 매니저 플레이 모드로 돌려보면 정상적으로 동작하는 걸 확인할 수 있을것

Default_Underwear_Parts_EXMenu_for_Kikyo.unitypackage

Default_Underwear_Parts_EXMenu_for_Kikyo.unitypackage

drive.google.com

---

그 외에도 개발자가 자체 제공하는 샘플이 있으니 참고하면 도움이 될거임 (컨텍트 리시버, 컨텍트 센더 등) 

Samples | Modular Avatar (nadena.dev)

---

궁금한 거 물어보면 아는 선에서는 답변해줄게