문제 해결
이 문서를 읽으면 MLC가 보여 준 검증·설치 메시지를 그대로 찾아 무엇을 고쳐야 하는지 알 수 있습니다.
먼저 확인할 것
- Console에 컴파일 오류가 남아 있는지 봅니다.
- 이렇게 되면 정상입니다. 오류가 없으면 인스펙터의 MLC 카드들이 전부 보입니다. 선택적 연동 어셈블리가 컴파일되지 않으면 MLC는 그 도구를 설치되지 않은 것으로 봅니다.
- 컴포넌트가 아바타 루트에 붙어 있는지 봅니다.
- 이렇게 되면 정상입니다. VRC 아바타 디스크립터가 붙은 바로 그 오브젝트에
Ming Light Controller컴포넌트가 함께 있습니다. MLC 창을 열어 두었다면아바타 루트줄이 그 오브젝트를 가리킵니다.
- 이렇게 되면 정상입니다. VRC 아바타 디스크립터가 붙은 바로 그 오브젝트에
설정 검증 (원본 변경 없음)을 누릅니다.- 이렇게 되면 정상입니다.
검증 완료가 표시됩니다. 다른 메시지가 나오면 아래에서 그 문장을 찾으세요.
- 이렇게 되면 정상입니다.
업로드가 다음 오류로 멈췄다면 검증 이전 문제입니다. MLC는 NDMF 빌드 클론 단계에서만 구성되므로, 프로젝트에 NDMF가 설치돼 있고 VRChat 빌드 처리에서 동작하는지부터 확인하세요.
Ming Light Controller was not prepared by the NDMF build-clone pass. Enable NDMF for VRC build processing.
메뉴 트리 위에 메뉴 트리를 편집할 수 없습니다: ... 가 떠 있다면 트리 자체가 규칙을 어긴 상태입니다. 같은 폴더 안에 순서가 겹치는 항목, 이름이 빈 항목, 폴더가 아닌 항목 밑에 들어간 항목이 흔한 원인입니다. 이 상태에서는 다른 검증도 통과하지 않습니다.
컴포넌트를 추가할 수 없습니다
GameObject > Studio Raming > Ming Light Controller > Add or Configure Component 를 눌렀는데 Console에 이 오류가 남는 경우입니다.
Select the avatar root, not a child mesh, before adding Ming Light Controller.
선택한 것이 아바타 루트로 인정되지 않았습니다. 다음 중 하나에 해당해야 합니다.
- VRC 아바타 디스크립터를 가진 오브젝트
Animator가 붙은 오브젝트- MingToon Manager가 붙은 오브젝트
- 자식에 렌더러를 가진 계층의 최상위 오브젝트
프로젝트 창의 프리팹 에셋을 선택한 상태로는 추가되지 않습니다. 씬에 올린 인스턴스를 고르세요. Play Mode 중에도 이 메뉴 항목은 동작하지 않습니다.
재질 속성을 우클릭해 등록할 때 나오는 메시지도 같은 계열입니다.
| 메시지 | 조치 |
|---|---|
먼저 아바타에 Ming Light Controller 컴포넌트를 추가하거나, 해당 아바타 루트를 선택한 뒤 속성을 등록하세요. | 아바타 루트에 컴포넌트를 먼저 붙입니다 |
여러 아바타에 Ming Light Controller가 있습니다. 이 컨트롤을 받을 아바타 루트를 선택한 뒤 다시 시도하세요. | 어느 아바타에 넣을지 루트를 직접 선택합니다 |
안정적인 asset ID가 있는 프로젝트 머티리얼을 선택하지 않았습니다. | 프로젝트에 에셋으로 저장된 머티리얼을 선택합니다 |
이 속성은 이미 '...'에 등록되어 있습니다. | 같은 범위·같은 속성이 이미 등록돼 있습니다. 그 그룹을 편집하세요 |
대상 바인딩이 없다고 나옵니다
검증이 이런 문장으로 실패하는 경우입니다.
Target is missing runtime bindings for: ...
켜 둔 기능이 움직여야 할 대상을 이 아바타에서 찾지 못했다는 뜻입니다. 뒤에 나열된 것이 못 찾은 기능들입니다.
확인 순서는 다음과 같습니다.
- 아바타에 MingToon 재질이 실제로 올라가 있는지 봅니다.
- 이렇게 되면 정상입니다. 렌더러의 재질 슬롯이 MingToon 셰이더를 쓰고 있습니다.
- 나열된 기능이 쓰는 프로퍼티가 그 재질에 있는지 봅니다. 대응표는 기능과 MingToon 프로퍼티에 있습니다.
- 이렇게 되면 정상입니다. 재질 인스펙터에서 그 값을 편집할 수 있습니다.
- 대상이 없는 기능은
메뉴 구성카드에서 체크를 끕니다.- 이렇게 되면 정상입니다. 다시 검증하면 그 기능이 목록에서 사라집니다.
포토 룩 비트를 고정했더니 설치가 거부됩니다
포토 룩 비트를 고정값으로 잠근 구성이 설치 단계에서 대상 바인딩 없음 오류로 거부되던 문제가 있었고, 수정됐습니다. 같은 증상이 남아 있다면 MLC를 최신 버전으로 올리세요.
두 프로파일 모두 예산을 넘습니다
두 프로파일 모두 동기화 예산을 넘습니다. 기능을 끄거나 일부를 로컬 전용(Synced 해제)으로 바꾸세요.
Smooth로도 Compact로도 들어가지 않는 상태입니다. 줄이는 방법은 둘입니다.
메뉴 구성카드에서 안 쓰는 기능이나 폴더의 체크를 끕니다. 폴더를 끄면 안쪽 전부가 함께 빠집니다.- 남들과 공유할 필요가 없는 기능은
선택 항목 설정에서동기화를 끕니다. 본인 화면에서만 바뀌는 대신 동기화 비트를 쓰지 않습니다.
고급 카탈로그 를 켜 둔 상태라면 그것부터 확인하세요.
Smooth만 예산을 넘습니다
Smooth 프로파일이 예산을 넘습니다. Compact를 쓰거나 기능을 줄이세요.
Compact로 바꾸면 들어갑니다. 프로필 을 Compact 로 두거나 자동 으로 두면 됩니다. 자동은 Smooth를 먼저 시도한 뒤 Compact로 내려갑니다.
Compact에서 동기화할 수 없는 항목이 있습니다
이 float은 compact bin이 2개 미만이라 Compact에서 동기화할 수 없습니다. 설치 시 로컬 전용이 됩니다.
Compact는 값을 단계로 나눠 보냅니다. 단계가 2개 미만이면 보낼 것이 없어 그 항목만 본인 화면 전용이 됩니다. 오류가 아니라 안내이며, 설치는 그대로 진행됩니다.
그 값을 남들에게도 보여야 한다면 Smooth 프로필을 쓰세요.
VRCFury provider가 없다고 나옵니다
VRCFury provider가 설치되지 않았습니다. VRCFury를 설치하거나 다른 build backend를 선택하세요.
VRCFury를 명시적으로 골랐는데 그 provider를 찾지 못한 경우입니다. 이때 MLC는 다른 방식으로 넘어가지 않고 실패하며, 설정 검증 (원본 변경 없음) 버튼도 함께 비활성화됩니다.
- VRCFury를 설치합니다. 지원 대상은 1.1426.0 이상입니다.
- 또는
고급 옵션의연결 방식을 다른 것으로 바꿉니다.
VRCFury를 설치했는데도 같은 메시지가 나온다면 Console에서 VRCFury 쪽 컴파일 오류를 확인하세요. 그 어셈블리가 컴파일되지 않으면 provider가 등록되지 않습니다.
Direct Descriptor가 병합을 거부합니다
Direct Descriptor는 이미 FX 컨트롤러 · Expressions 메뉴 · Expression Parameters 중 하나라도 쓰고 있는 아바타에 병합하지 않습니다. 부착에 실패하면 복제본을 이전 상태로 되돌립니다.
그런 아바타에는 Modular Avatar나 VRCFury를 쓰세요.
VRCSDK를 찾지 못했습니다
VRCSDK Avatars를 찾지 못했습니다. 코어 compile plan은 계속 검증할 수 있습니다.
구성과 예산 계산은 계속할 수 있지만 업로드는 되지 않습니다. VRChat Avatars SDK 3.x를 프로젝트에 넣으세요.
이전 버전이 남긴 생성물
예전 MLC는 원본 아바타에 생성 폴더와 MLC 소유 하위 오브젝트를 남길 수 있었습니다. 지금 버전은 그것들을 건드리지 않고 무시합니다.
컴포넌트 인스펙터에는 이전 버전 생성물 정리 버튼이 항상 있습니다. 연결 창 쪽은 소유 정보가 확인됐을 때만 안내와 함께 이전 버전 소유 생성물 정리 버튼을 보여 줍니다.
두 버튼 모두 소유가 증명된 경로와 컴포넌트만 지우고, 원본 FX · 메뉴 · 파라미터 · 머티리얼은 보존합니다. 정리할 대상이 없으면 MLC 소유 manifest를 찾지 못했습니다. 가 나오고 아무것도 지우지 않습니다.
정리 대화상자가 이 점을 명시합니다. 실행 전에 프로젝트 백업이나 버전 관리 상태를 확인하세요.
정리가 중간에 멈추면 다음 메시지 중 하나가 나옵니다.
| 메시지 | 조치 |
|---|---|
이전 MLC host를 제거하지 못해 생성 자산 정리를 중단했습니다: ... | 뒤에 붙은 이유를 먼저 해결합니다 |
MLC Modular Avatar host가 소유 메뉴 또는 FX 자산을 아직 참조하여 생성 폴더 정리를 중단했습니다. host를 먼저 제거하세요. | 남아 있는 host를 먼저 제거합니다 |
MLC 생성 자산 정리 결과를 받지 못했습니다. | 다시 시도하고, 반복되면 문의하세요 |
MLC 소유 manifest를 찾지 못했습니다. | 정리할 소유 생성물이 없습니다. 남아 있는 것은 MLC가 만든 것이 아닙니다 |
메뉴가 아바타에 보이지 않습니다
검증은 통과했는데 인게임이나 미리보기에 메뉴가 없다면 순서대로 확인하세요.
고급 옵션의연결 방식이Standalone인지 봅니다.- 이렇게 되면 정상입니다. Standalone이 아니어야 아바타에 컨트롤이 붙습니다. Standalone은 설계상 아무것도 붙이지 않습니다.
빌드 clone 준비 허용이 켜져 있는지 봅니다.- 이렇게 되면 정상입니다. 꺼져 있으면 복제본에서 컴포넌트만 제거되고 메뉴가 만들어지지 않습니다.
- Play Mode 미리보기에서 확인하는 중이라면
Play Mode 미리보기가 켜져 있는지, 컴포넌트 자체가 활성인지 봅니다.- 이렇게 되면 정상입니다. 둘 다 켜져 있어야 Play Mode 복제본에 컨트롤이 생깁니다.
예산·검증카드의켜진 기능이 0이 아닌지 봅니다.- 이렇게 되면 정상입니다. 기능이 하나도 켜져 있지 않으면 빌드는 성공하지만 만들 메뉴가 없습니다.
메뉴 구성카드의 루트가 8칸을 넘지 않았는지 봅니다.- 이렇게 되면 정상입니다.
루트 (n / 8)의 앞 숫자가 8 이하입니다. 넘친 항목은 아바타에서 보이지 않습니다.
- 이렇게 되면 정상입니다.
그래도 안 되면
Console 오류 전문과 예산·검증 카드의 내용을 함께 보내 주세요.