컴포넌트 인스펙터

이 문서를 읽으면 인스펙터 카드 다섯 개와 두 개의 창이 각각 무엇을 편집·검증하는지 알고, 필요한 항목을 찾아갈 수 있습니다.

컴포넌트가 저장하는 것

컴포넌트는 이 아바타 한 대의 설정값만 들고 있습니다. 인스펙터 맨 위 안내문이 범위를 그대로 말합니다.

이 컴포넌트는 이 아바타 전용 설정만 담습니다. 원본 FX·메뉴·파라미터·머티리얼은 건드리지 않으며, 실제 MLC 구성은 Play Mode 또는 업로드 build clone에서만 만들어집니다.

저장되는 값은 다음과 같습니다.

저장 항목	편집 위치
프로필	빠른 시작
메뉴 배치 — 폴더·항목·순서·포함 여부	메뉴 구성
기능별 수정	선택 항목 설정
머티리얼 그룹 등록	선택 항목 설정
연결 방식, 고급 카탈로그, 목표 예산, Play Mode 미리보기, 빌드 clone 준비 허용	고급 옵션

기능별 수정은 바꾼 항목만 저장됩니다. 손대지 않은 기능은 카탈로그 기본값을 그대로 따르므로, MLC를 새 버전으로 올려 어떤 기능의 범위나 기본값이 바뀌면 이미 설정해 둔 아바타에도 그 변경이 반영됩니다.

한 오브젝트에는 컴포넌트가 하나만 붙습니다. 아바타가 여러 대면 각 아바타 루트마다 따로 붙이고, 아바타별로 다른 구성을 쓸 수 있습니다.

카드 순서

인스펙터는 위에서 아래로 다음 순서입니다.

1. 제품 이름과 언어 드롭다운
2. 안내문
3. 빠른 시작
4. 메뉴 구성
5. 선택 항목 설정
6. 예산·검증
7. 고급 옵션

언어 드롭다운은 한국어 · English · 日本語 중에서 고릅니다. 이 값은 Studio Raming 에디터 도구가 함께 쓰므로, 한 곳에서 바꾸면 다른 도구도 같은 언어로 표시됩니다.

빠른 시작

세 가지가 들어 있습니다.

항목	하는 일
시작 프리셋	출발점을 고릅니다. 추천 · 비트 절약 · 촬영 중심 · 성능 · 빈 구성 · 사용자 지정
프로필	자동 · Smooth · Compact. 자동은 기존 아바타 예산을 감안해 Smooth를 먼저 시도하고 안 되면 Compact를 씁니다
적용	고른 프리셋을 실제로 적용합니다

적용은 확인 대화상자를 한 번 띄우고, 누르면 기능별 수정을 전부 지운 뒤 메뉴 배치를 통째로 교체합니다. Undo로 되돌릴 수 있습니다. 각 프리셋의 내용은 시작 프리셋에 있습니다.

프로필만 바꾸는 것은 프리셋 적용이 아닙니다. 드롭다운을 바꾼 즉시 값이 저장되고, 적용을 누를 필요가 없습니다.

메뉴 구성

최종 메뉴의 폴더와 순서를 편집하는 트리입니다. 카드 안내문이 역할 경계를 말합니다.

메뉴 배치와 기능 포함 여부만 정합니다. 동기화 비트와 파라미터 비용은 예산 카드에서 확인하세요. 실제 에셋은 Play Mode·업로드 clone에서만 생성됩니다.

카드 위쪽에 버튼 두 개가 있습니다.

버튼	하는 일
추천 메뉴 적용	메뉴 배치만 권장 구조로 되돌립니다. 기능별 설정은 유지합니다
빈 메뉴에서 시작	메뉴 배치만 전부 비웁니다. 기능 설정과 머티리얼 그룹 등록은 유지합니다

그 아래 루트 줄은 현재 최상위 항목 수를 루트 (n / 8) 형식으로 보여 줍니다. 8은 VRChat Expressions Menu 한 페이지의 슬롯 수입니다.

각 줄에서 할 수 있는 일입니다.

• 체크박스 — 이 항목을 최종 메뉴와 파라미터 비용에서 빼거나 다시 넣습니다. 폴더의 체크를 끄면 그 안의 모든 항목이 함께 빠집니다.
• 이름 — 그 자리에서 편집합니다. 직접 바꾼 이름은 언어를 바꿔도 그대로 남습니다.
• ≡ 손잡이 — 드래그해서 순서를 바꾸거나 다른 폴더로 옮깁니다. 목록 맨 아래 루트 맨 아래로 이동 자리에 놓으면 최상위 메뉴의 마지막으로 갑니다.
• + 항목 — 폴더 · 기능 · 머티리얼 그룹 · 명령 중 하나를 새로 추가합니다.
• 삭제 — 이 메뉴 배치만 지웁니다. 기능 설정과 머티리얼 원본은 지우지 않습니다.

메뉴가 비어 있으면 트리에 다음 안내가 뜹니다.

빈 메뉴입니다. '+ 항목'으로 직접 구성하거나 '추천 메뉴'를 적용하세요.

선택 항목 설정

메뉴 구성 트리에서 선택한 항목 하나의 상세만 표시합니다. 아무것도 고르지 않았으면 안내만 나옵니다.

메뉴 트리에서 기능 또는 머티리얼 그룹을 선택하면 상세 설정이 여기에 표시됩니다.

폴더나 명령을 고르면 「폴더는 메뉴 트리에서 이름·순서·포함 여부를 편집합니다.」처럼 편집 위치만 알려 줍니다. 실제로 편집할 것이 있는 대상은 기능과 머티리얼 그룹 둘뿐입니다.

기능을 골랐을 때

항목	하는 일
사용	이 기능을 최종 메뉴와 빌드 계획에 포함합니다
애니메이션	끄면 설치 시 고정값만 적용되고 메뉴·Animator 레이어·파라미터가 만들어지지 않습니다
저장	켜면 아바타를 다시 불러온 뒤에도 마지막 값을 유지합니다. 메뉴·비트 비용은 변하지 않습니다
동기화	끄면 본인 화면에서만 바뀌고 동기화 비트 비용이 0이 됩니다
원래 값 복원	이 기능을 끌 때 머티리얼에 저장된 원래 값으로 되돌립니다
값 고정	메뉴에 노출하지 않고 값을 고정합니다
고정값	값 고정을 켰을 때 적용할 값. 꺼져 있으면 편집할 수 없습니다
고정 적용값	애니메이션이 꺼졌을 때 모든 대상에 적용할 값. 켜져 있으면 편집할 수 없습니다
범위	이 기능의 최소·최대와 괄호 안의 기본값. 읽기 전용입니다

맨 아래 카탈로그 기본값으로 되돌리기 버튼은 이 기능에 저장된 수정이 있을 때만 나타납니다. 누르면 그 기능의 사용자 수정만 지워지고 다른 기능과 원본 머티리얼은 그대로입니다.

값을 바꿨다가 원래대로 되돌려 놓으면 그 기능의 저장 항목이 자동으로 사라집니다. 토글을 한 번 눌렀다는 이유만으로 값이 고정되지는 않습니다.

Compact에서 동기화할 수 없는 기능

동기화를 켠 실수형 기능 중 일부에는 다음 경고가 붙습니다.

이 float은 compact bin이 2개 미만이라 Compact에서 동기화할 수 없습니다. 설치 시 로컬 전용이 됩니다.

Compact 프로필에서는 그 기능이 자동으로 로컬 전용이 된다는 뜻입니다. Smooth에서는 정상 동기화됩니다.

머티리얼 그룹을 골랐을 때

항목	하는 일
그룹 이름	표시 이름만 바꿉니다. 등록된 머티리얼과 속성 연결은 유지됩니다
속성	이 그룹이 다루는 속성과 범위. 읽기 전용입니다
대상	등록된 머티리얼 수, 또는 「아바타의 모든 MingToon 머티리얼」. 읽기 전용입니다
메뉴 조정	끄면 이 그룹은 메뉴·파라미터를 만들지 않고 아래 고정값만 적용합니다
저장	마지막 메뉴 값을 아바타 재로드 후에도 유지합니다
동기화	끄면 다른 사용자에게 전송하지 않아 동기화 비트 비용이 0입니다
고정값	메뉴 조정이 꺼졌을 때 모든 대상 머티리얼에 적용할 값
자동 페이지	생성 항목이 8슬롯을 넘으면 자동으로 하위 페이지를 나눕니다
그룹 해제	이 등록만 제거합니다. 머티리얼 원본은 바뀌지 않습니다

저장과 동기화는 메뉴 조정이 켜져 있을 때만 편집할 수 있고, 고정값은 그 반대입니다.

예산·검증

현재 구성이 VRChat 파라미터 예산에 들어가는지 보여 줍니다.

줄	읽는 법
동기화 비트	Smooth로 만들 때와 Compact로 만들 때의 동기화 비트, 그리고 괄호 안의 예산
아바타 합계	MLC가 아닌 기존 파라미터가 쓰는 비트·항목 수와, 설정한 목표값
현재 선택	실제로 선택된 프로필과 그 비용. 넘치면 「초과 / 생성 불가」
켜진 기능	켜진 기능 수 / 카탈로그 전체 기능 수

두 프로필이 모두 예산을 넘으면 오류가, Smooth만 넘으면 경고가 표시됩니다. 대응 방법은 프로필과 파라미터 예산에 있습니다.

이 카드 안쪽에 검증 상자가 하나 더 있고, 거기에 설정 검증 (원본 변경 없음)과 이전 버전 생성물 정리 버튼, 그리고 읽기 전용 Play Mode 미리보기 줄이 들어 있습니다.

고급 옵션

접혀 있는 것이 기본이고, 접힌 상태에서는 안내만 보입니다.

메뉴 트리에서 포함할 항목과 프로필을 먼저 조정하세요.

펼치면 다음 항목이 나옵니다.

항목	하는 일
연결 방식	컴파일된 컨트롤러를 아바타에 붙이는 방식
고급 카탈로그	기본 기능 외 고급 조정 항목을 포함합니다. 켠 기능만큼 메뉴·파라미터 비용이 늘어납니다
동기화 비트 목표	0이면 남은 VRC 예산을 자동으로 씁니다. 그 외에는 아바타 전체 상한입니다
파라미터 항목 목표	0이면 VRC 최대값을 씁니다. 그 외에는 아바타 전체 항목 상한입니다
알 수 없는 예산에서 강제 설치	기존 VRC 파라미터를 읽을 수 없을 때 외부 예산을 비어 있는 것으로 가정합니다
빌드 clone 준비 허용	원본을 바꾸지 않는 빌드 클론 구성을 허용합니다
Play Mode 미리보기	Play Mode 복제본에 MLC 컨트롤을 만들지 정합니다
진단 표시	개발용 내부 진단을 표시합니다

강제 설치는 마지막 수단입니다

알 수 없는 예산에서 강제 설치는 외부 예산을 0으로 가정하므로 VRC 한도를 넘길 수 있습니다. 아바타를 직접 확인한 경우에만 켜세요.

맨 아래에 저장된 수정 줄과 모든 수정 초기화 버튼이 있습니다. 수정이 하나도 없으면 「없음 (전부 카탈로그 기본값)」으로 표시되고 버튼은 비활성 상태입니다.

진단 표시를 켜면 재질 바인딩 진단 아래에 메뉴 항목 수 · 기능 수정 수 · 머티리얼 그룹 수가 한 줄로 나옵니다.

설정 검증

예산·검증 카드의 설정 검증 (원본 변경 없음) 버튼입니다.

1. 버튼을 누릅니다.
2. 결과 대화상자를 읽고 확인을 누릅니다.

이렇게 되면 정상입니다. 결과 메시지가 대화상자로 뜨고 아바타는 그대로입니다. 이 버튼은 현재 설정이 Play Mode·업로드 빌드 클론에서 생성 가능한지만 검사하며, 원본 아바타와 VRC 에셋을 수정하지 않습니다.

연결 방식을 VRCFury로 명시했는데 연동이 설치되지 않았다면 버튼이 비활성화되고 경고가 함께 표시됩니다.

이전 버전 생성물 정리

같은 상자의 두 번째 버튼입니다. 예전 MLC 버전은 원본 아바타에 생성 폴더와 MLC 소유 host를 남길 수 있었고, 이 버튼은 그 잔여물만 지웁니다.

1. 이전 버전 생성물 정리를 누릅니다.
2. 확인 대화상자를 읽고 소유 생성물 정리를 누릅니다.

이렇게 되면 정상입니다. 결과 메시지가 대화상자로 뜹니다. 지울 것이 없으면 「MLC 소유 manifest를 찾지 못했습니다.」가 나옵니다.

정리는 되돌릴 수 없습니다

소유권이 확인된 host와 생성 자산만 제거하고 원본 FX·메뉴·파라미터·머티리얼은 보존하지만, 생성 자산 파일 삭제는 Unity Undo로 복구되지 않습니다.

이 정리는 컴포넌트를 켜거나 끌 때, Hierarchy가 바뀔 때, Play Mode에 들어갈 때 자동으로 실행되지 않습니다. 버튼을 눌렀을 때만 동작합니다.

두 개의 창

컴포넌트 인스펙터 말고 창이 두 개 더 있습니다. 둘 다 검증용이고, 기능별 설정은 컴포넌트에서 편집합니다.

창	여는 경로	무엇을 하나
밍 라이트 컨트롤러	StudioRaming > Ming Light Controller > Open	예산 계산 / 프로필 선택, 아바타 대상 / standalone 계획 검증, MLC 구성 / 빌드 준비 검증을 실행하고 적용 카탈로그와 빌드 계획을 봅니다
밍 라이트 컨트롤러 · 빌드 설정	StudioRaming > Ming Light Controller > Avatar Attachment	표현 프로필 · 빌드 백엔드 · 전체 카탈로그 사용을 확인하고 빌드 준비 검증 (원본 변경 없음)을 실행합니다

첫 창의 안내문이 경계를 그대로 말합니다.

이 창은 MLC 구성과 예산을 미리 검증합니다. 원본 아바타에는 Expression Parameters, Menu, FX Animator, Clip이나 연결 host를 생성하지 않습니다. 실제 구성은 Play Mode 또는 업로드 build clone에서만 적용됩니다.

두 창 모두 아바타의 컴포넌트를 따릅니다. 아바타에 컴포넌트가 없으면 Ming Light Controller 컴포넌트 추가 버튼과 함께 다음 안내가 나오고, 창에서 고른 값은 저장되지 않습니다.

이 아바타에는 MLC 컴포넌트가 없습니다. 위 값은 아직 저장되지 않습니다. 컴포넌트를 추가한 뒤 그 Inspector에서 기능을 구성하세요.

저장된 수정 되돌리기

하고 싶은 것	방법
방금 한 편집 취소	Undo(Ctrl+Z)
기능 하나만 원래대로	선택 항목 설정의 카탈로그 기본값으로 되돌리기
기능별 수정 전부 삭제	고급 옵션의 모든 수정 초기화 — 메뉴 배치와 머티리얼 원본은 유지
메뉴 배치만 권장 구조로	메뉴 구성의 추천 메뉴 적용 — 기능별 설정은 유지
메뉴 배치만 비우기	메뉴 구성의 빈 메뉴에서 시작 — 기능 설정과 머티리얼 그룹 등록은 유지
전부 출발점으로	빠른 시작의 적용 — 기능별 수정을 지우고 메뉴 배치도 교체

선택 항목 설정 · 메뉴 구성 · 고급 옵션 중 어디든 손대면 시작 프리셋 값이 사용자 지정으로 바뀝니다. 표시가 바뀔 뿐이고 동작이 달라지지는 않습니다.

관련 문서

문서	언제 읽나
첫 메뉴 만들기	컴포넌트를 붙이고 업로드까지 한 번 해 볼 때
시작 프리셋	빠른 시작에서 무엇을 고를지 정할 때
프로필과 파라미터 예산	예산·검증의 숫자가 빨갛게 나올 때