메뉴 구성

이 문서를 읽으면 메뉴 트리에서 폴더와 항목을 직접 배치하고, MingToon 재질의 임의 속성을 머티리얼 그룹으로 메뉴에 올릴 수 있습니다.

메뉴 트리는 아바타 루트에 붙인 Ming Light Controller 컴포넌트 인스펙터의 메뉴 구성 카드에 있습니다. 이 카드에서 정하는 것은 배치와 포함 여부뿐입니다. 실제 메뉴·파라미터·FX 자산은 Play Mode 미리보기나 업로드 빌드 클론에서만 만들어집니다.

기본 루트 7칸

추천 메뉴 적용을 누르면 루트에 일곱 칸이 놓입니다.

순서	트리에 보이는 이름	종류
1	`초기화`	명령
2	`최종 출력`	기능
3	`색조 / 채도 컬러 휠`	기능
4	`포토 룩`	폴더
5	`가상 조명`	폴더
6	`마스터 조정`	폴더
7	`성능`	폴더

각 폴더 안에 무엇이 들어 있고 그것이 MingToon 재질의 어떤 값을 움직이는지는 기능과 MingToon 프로퍼티에 있습니다.

이름을 직접 고치지 않은 항목은 MLC가 인식하는 기본 이름이므로, 언어 설정을 바꾸면 표시 이름도 함께 바뀝니다. 한 번이라도 이름을 고치면 그 이름은 언어와 상관없이 입력한 그대로 유지됩니다.

한 페이지는 8슬롯

카드의 루트 줄은 루트 (n / 8) 형태로 현재 루트 항목 수를 보여 줍니다. VRChat Expressions Menu는 한 페이지에 최대 8개 슬롯만 표시하므로, 루트가 8칸을 넘으면 넘친 항목은 아바타에서 보이지 않습니다.

8칸을 넘길 것 같다면

관련 항목을 폴더로 묶으세요. 폴더 하나가 루트에서 한 칸만 차지합니다. 이 8칸 제한은 폴더 안쪽에도 똑같이 적용됩니다.

항목 네 종류

+ 항목 버튼으로 추가할 수 있는 종류는 넷입니다.

종류	하는 일	담을 수 있는 것
`폴더`	하위 페이지를 만듭니다	아무 컨트롤도 담지 않습니다
`기능`	카탈로그 기능을 메뉴에 노출합니다	기능 하나 이상
`머티리얼 그룹`	등록한 재질 속성을 노출합니다	머티리얼 그룹 하나
`명령`	정해진 MLC 명령을 실행합니다	명령 값 하나

각 종류는 자기 것만 담을 수 있습니다. 폴더에 컨트롤을 직접 넣거나, 기능 항목에 머티리얼 그룹이나 명령을 함께 넣으면 검증에서 거부됩니다. 폴더가 아닌 항목 밑에 다른 항목을 넣는 것도 거부됩니다.

명령 항목은 자기가 움직일 기능이 켜져 있어야 최종 메뉴에 들어갑니다. 명령별 조건은 아래 관련 문서의 "기능과 MingToon 프로퍼티" 명령 절에 있습니다.

항목 추가와 이동

아바타 루트를 선택하고 인스펙터에서 메뉴 구성 카드를 폅니다.
- 이렇게 되면 정상입니다. 카드 맨 위에 루트 (n / 8) 줄과 그 아래 트리가 보입니다.
카드 위쪽 + 항목을 누르고 폴더 · 기능 · 머티리얼 그룹 · 명령 중 하나를 고릅니다. 특정 폴더 안에 바로 넣으려면 그 폴더 줄의 추가 버튼을 씁니다.
- 이렇게 되면 정상입니다. 루트(또는 그 폴더)의 맨 아래에 새 줄이 생깁니다.
줄을 드래그해 순서를 바꾸거나 다른 폴더 안으로 옮깁니다. 최상위 맨 아래로 보내려면 트리 아래쪽 루트 맨 아래로 이동 영역에 놓습니다.
- 이렇게 되면 정상입니다. 놓은 자리에 줄이 들어가고, 루트 줄의 n / 8 숫자가 옮긴 결과에 맞게 바뀝니다.
이름 칸을 눌러 표시 이름을 고칩니다.
- 이렇게 되면 정상입니다. 이름만 바뀌고 그 항목이 가리키는 기능·그룹·명령은 그대로입니다.

같은 폴더 안에서 두 항목이 같은 순서 번호를 갖거나, 이름이 빈 항목이 남아 있으면 트리 위에 메뉴 트리를 편집할 수 없습니다: ... 가 뜨고 편집이 막힙니다.

체크박스로 제외하기

각 줄 앞의 체크박스는 그 항목을 최종 메뉴와 파라미터 비용에서 빼는 스위치입니다. 배치는 트리에 그대로 남습니다.

항목을 끄면 그 항목만 빠집니다.
폴더를 끄면 그 폴더와 안쪽 모든 항목이 함께 빠집니다.

비용을 줄이고 싶은데 나중에 다시 쓸 것 같다면, 삭제하지 말고 체크를 끄세요. 다시 켜면 배치를 새로 만들 필요가 없습니다.

고급 설정 폴더는 기본으로 꺼져 있습니다

추천 메뉴 적용이 만드는 트리에는 마스터 조정 아래에 고급 설정 폴더가 있고, 이 폴더는 체크가 꺼진 상태로 만들어집니다. 안쪽에는 밝기 · 광원 반응 · 색상 보정 세 폴더가 들어 있습니다.

기본 카탈로그에는 이 폴더가 쓰는 기능이 들어 있지 않기 때문입니다. 쓰려면 두 가지를 함께 해야 합니다.

인스펙터 고급 옵션 카드에서 고급 카탈로그를 켭니다.
- 이렇게 되면 정상입니다. 예산·검증 카드의 켜진 기능 수가 늘어납니다.
메뉴 구성 카드에서 고급 설정 폴더의 체크박스를 켭니다.
- 이렇게 되면 정상입니다. 폴더가 최종 메뉴에 포함되고 동기화 비트 값이 올라갑니다.

먼저 예산을 보세요

고급 카탈로그 항목은 전부 라디얼입니다. 켠 만큼 동기화 비트와 파라미터 항목 수가 늘어나므로, 켠 뒤에는 예산·검증 카드를 확인하세요.

머티리얼 그룹 등록

카탈로그에 없는 MingToon 재질 속성도 메뉴에 올릴 수 있습니다. 재질 인스펙터에서 그 속성을 우클릭하는 것이 진입점입니다.

아바타 루트에 Ming Light Controller 컴포넌트가 붙어 있는지 확인합니다.
- 이렇게 되면 정상입니다. 없으면 등록할 때 먼저 아바타에 Ming Light Controller 컴포넌트를 추가하거나, 해당 아바타 루트를 선택한 뒤 속성을 등록하세요. 가 뜹니다.
MingToon 재질을 선택하고, 인스펙터에서 올리고 싶은 속성의 라벨을 우클릭합니다.
- 이렇게 되면 정상입니다. 컨텍스트 메뉴에 Ming Light Controller 항목이 생깁니다.
Ming Light Controller > 선택한 머티리얼 등록 또는 Ming Light Controller > 아바타의 모든 MingToon 머티리얼 등록 을 고릅니다.
- 이렇게 되면 정상입니다. 메뉴 트리 루트에 사용자 컨트롤 폴더가 (없었다면) 생기고, 그 안에 속성 이름을 단 머티리얼 그룹 항목이 추가됩니다. 이 폴더는 자동으로 켜집니다.

등록할 수 있는 속성 타입과 조건은 다음과 같습니다.

속성 타입	등록 방식	메뉴에서 쓰는 범위
`Float`	그대로 한 항목	현재 값과 0~1을 모두 포함하도록 잡힙니다
`Range`	그대로 한 항목	슬라이더에 선언된 범위
`Color`	`R` · `G` · `B` · `A` 성분별로 나뉩니다	현재 값과 0~1을 모두 포함하도록 잡힙니다
`Vector`	`X` · `Y` · `Z` · `W` 성분별로 나뉩니다	현재 값과 -1~1을 모두 포함하도록 잡힙니다

색상과 벡터는 성분 하나를 반드시 골라야 합니다. 우클릭 메뉴가 성분별 하위 항목으로 나뉘는 이유입니다. 반대로 Float · Range 는 성분 접미사를 붙일 수 없습니다.

선택한 머티리얼 등록 은 프로젝트에 에셋으로 저장된 머티리얼에만 씁니다. 안정적인 asset ID를 얻을 수 없는 대상만 선택돼 있으면 안정적인 asset ID가 있는 프로젝트 머티리얼을 선택하지 않았습니다. 로 거부됩니다.

같은 범위·같은 속성이 이미 등록돼 있으면 이 속성은 이미 '그룹 이름'에 등록되어 있습니다. 가 뜨고 중복 등록되지 않습니다.

머티리얼 그룹 설정

트리에서 머티리얼 그룹 항목을 선택하면 선택 항목 설정 카드에 그 그룹만 표시됩니다.

항목	하는 일
`그룹 이름`	이름만 바꿉니다. 등록된 머티리얼과 속성 연결은 그대로입니다
`속성`	이 그룹이 움직이는 재질 속성
`대상`	`아바타의 모든 MingToon 머티리얼` 이거나, 등록할 때 선택한 머티리얼 목록
`메뉴 조정`	끄면 메뉴와 파라미터를 만들지 않고 아래 `고정값`만 적용합니다
`저장`	켜면 아바타를 다시 불러온 뒤에도 마지막 값을 유지합니다
`동기화`	끄면 본인 화면에서만 바뀌고 동기화 비트를 쓰지 않습니다
`고정값`	`메뉴 조정`이 꺼졌을 때 대상 머티리얼 전체에 적용할 값
`자동 페이지`	생성 항목이 8슬롯을 넘으면 자동으로 하위 페이지를 나눕니다
`그룹 해제`	이 등록만 제거합니다. 머티리얼 원본은 바뀌지 않습니다

제거해도 남는 것

트리에서 줄을 지우는 것은 그 배치만 지우는 일입니다.

지운 것	함께 사라지는 것	남는 것
항목 한 줄	그 배치	기능별 설정, 머티리얼 원본
폴더 한 줄	폴더와 그 안의 배치 전부	기능별 설정, 머티리얼 원본
머티리얼 그룹 항목	그 배치	그룹 등록 자체 (`그룹 해제`로 따로 지웁니다)

기능별로 저장해 둔 설정을 지우려면 선택 항목 설정의 카탈로그 기본값으로 되돌리기(한 기능) 또는 모든 수정 초기화(전체)를 씁니다. 이 두 동작도 메뉴 배치와 머티리얼 원본은 건드리지 않습니다.

기본 루트 7칸​

한 페이지는 8슬롯​

항목 네 종류​

항목 추가와 이동​

체크박스로 제외하기​

고급 설정 폴더는 기본으로 꺼져 있습니다​

머티리얼 그룹 등록​

머티리얼 그룹 설정​

추천 메뉴 적용 · 빈 메뉴에서 시작​

제거해도 남는 것​

관련 문서​