Ming Light Controller
이 문서를 읽으면 Ming Light Controller가 아바타에 무엇을 만들고 무엇을 만들지 않는지 알고, 다음에 읽을 문서를 고를 수 있습니다.
Ming Light Controller란
Ming Light Controller(MLC)는 MingToon 재질을 쓰는 아바타용 VRChat Expressions 메뉴를 만들어 주는 별매 Unity 애드온입니다. MLC를 설치해도 MingToon 셰이더 패키지가 대체되지는 않습니다.
MingToon 본체는 아바타에 Expressions 메뉴·파라미터·FX 레이어를 만들지 않습니다. 착용자가 VRChat 안에서 조명·그림자·포토 룩 값을 직접 돌리게 하려면 그 값을 노출할 메뉴가 따로 있어야 하고, 그 메뉴를 만드는 쪽이 MLC입니다.
원본 아바타에는 아무것도 설치되지 않습니다
컴포넌트 인스펙터 맨 위 안내문이 그대로 설명합니다.
이 컴포넌트는 이 아바타 전용 설정만 담습니다. 원본 FX·메뉴·파라미터·머티리얼은 건드리지 않으며, 실제 MLC 구성은 Play Mode 또는 업로드 build clone에서만 만들어집니다.
구체적으로는 이렇습니다.
- 편집 중인 아바타에 붙는 것은 설정 컴포넌트 하나뿐입니다.
- 메뉴·Expression Parameters·애니메이션 클립·FX 컨트롤러는 NDMF가 만든 일회용 복제본에서만 생성됩니다.
- 이 경로는 NDMF를 거치는 Play Mode 미리보기와 VRChat 업로드 빌드가 함께 씁니다.
- 원본 아바타와 그 VRC 디스크립터, 기존 FX·메뉴·파라미터 에셋은 바뀌지 않습니다.
- 완성된 복제본에서는 설정 컴포넌트 자체도 제거됩니다.
- 남는 생성 폴더가 없습니다. NDMF의 에셋 저장 경로 없이 호출되면 폴더를 만드는 대신 진단 메시지를 내고 실패합니다.
MLC의 모든 기능을 끈 상태로 빌드하면, 런타임 구성을 만들지도 붙이지도 않은 채로 빌드가 그대로 성공합니다.
쓰려면 필요한 것
| 항목 | 내용 |
|---|---|
| VRChat | VRChat Avatars SDK 3.x |
| 빌드 파이프라인 | NDMF 1.x |
| 재질 | 대상 아바타에 MingToon 재질 |
| 연결 방식 | Modular Avatar · VRCFury · 빈 VRC 아바타 디스크립터(Direct) 중 하나 |
VRCFury 연동은 1.1426.0 이상의 공개 API를 대상으로 합니다. Modular Avatar와 VRCFury는 선택 사항이며, MLC가 둘 중 어느 것도 대신 설치하지 않습니다.
설치 절차는 설치에 있습니다.
기본 메뉴 한눈에 보기
기본 카탈로그를 그대로 두면 루트 메뉴는 7칸입니다.
| 칸 | 이름 |
|---|---|
| 1 | 초기화 |
| 2 | 최종 출력 |
| 3 | 색조 / 채도 컬러 휠 |
| 4 | 포토 룩 |
| 5 | 가상 조명 |
| 6 | 마스터 조정 |
| 7 | 성능 |
가상 조명 폴더에는 조명 켜고 끄기, 방향, 밝기, 캐릭터 방향 추적, 모드가 들어갑니다. 성능 폴더에는 그림자 투사, 깊이 효과, 아웃라인, 노멀 맵, PBR / 반사, 성능 거리 배율과 전부 해제·전부 켜기 명령이 들어갑니다.
기본 항목 이름은 MLC의 언어 설정을 따라 표시됩니다. 직접 바꾼 이름은 언어를 바꿔도 그대로 남습니다.
메뉴 구성에서 제외한 기능은 컴파일된 메뉴에서도, 그 파라미터 비용에서도 함께 빠집니다.
문서 안내
처음이라면 설치 → 첫 메뉴 만들기 순서로 두 문서만 따라가면 업로드까지 한 번 끝납니다. 나머지는 필요할 때 찾아 읽는 문서입니다.
| 문서 | 언제 읽나 |
|---|---|
| 설치 | 프로젝트에 MLC를 처음 넣을 때 |
| 첫 메뉴 만들기 | 컴포넌트를 붙이고 업로드까지 한 번 해 볼 때 |
| 컴포넌트 인스펙터 | 인스펙터 카드와 두 개의 창에서 무엇을 편집하는지 볼 때 |
| 시작 프리셋 | 다섯 개 시작값 중 무엇을 고를지 정할 때 |
| 메뉴 구성 | 폴더·항목 순서를 바꾸거나 머티리얼 그룹을 등록할 때 |
| 기능과 MingToon 프로퍼티 | 메뉴 항목이 어떤 재질 값을 움직이는지 확인할 때 |
| 프로필과 파라미터 예산 | 동기화 비트·파라미터 항목이 모자랄 때 |
| 포토 룩 | 촬영용 여덟 개 항목을 쓰거나 뺄 때 |
| 빌드와 업로드 | 연결 방식과 빌드 클론 동작을 확인할 때 |
| VRChat | 업로드 직전 플랫폼 한도를 최종 점검할 때 |
| 문제 해결 | 경고·오류 메시지가 떴을 때 |
| 패치노트 | 버전별 변경 사항을 볼 때 |
| 서드파티 표기 및 라이선스 | 의존 패키지의 권리 표기를 확인할 때 |