설치
이 페이지를 끝내면 MingToon이 오류 없이 들어간 Unity 프로젝트가 생깁니다. 약 15분 걸립니다.
시작 전 준비
- Unity Hub와 아래 표에 맞는 Unity 버전, 그리고 작업할 프로젝트의 백업
- VRChat 대상이라면 VRChat SDK3 (Avatars)
1. Unity 버전을 맞춥니다
| 대상 | Unity |
|---|---|
| VRChat PC | 2022.3.22f1 |
| Warudo | 2021.3.45f2 |
| 일반 Unity | 2021.3 LTS |
VRChat 대상이면 2022.3.22f1을 쓰세요. MingToon의 VRChat 빌드 훅은 2022.3 이상에서만 컴파일됩니다. 2021.3 프로젝트에는 업로드 자동 최적화가 아예 없습니다. 한 프로젝트로 VRChat과 Warudo를 함께 대응할 수 없으니 나누세요.
2. 패키지를 설치합니다
공식 다운로드 안내에서 VCC 또는 BOOTH를 고릅니다.
VCC로 설치할 때:
- 다운로드 안내에서 VCC에 추가를 누릅니다.
- VCC에서 저장소 추가를 확인합니다.
- 대상 프로젝트의 Manage Project를 엽니다.
- MingToon을 추가하고 Unity를 엽니다.
BOOTH 설치기로 설치할 때:
- BOOTH 상품에서 설치기
.unitypackage를 받습니다. - Unity에서
Assets > Import Package > Custom Package로 임포트합니다. - 인터넷에 연결한 채로 기다립니다. 설치기가 본체를 자동으로 받습니다.
VCC로 설치했다면 업데이트도 VCC에서 합니다. 대상 프로젝트의 Manage Project > Manage Packages에서 MingToon을 올립니다. BOOTH 설치기는 Unity를 켤 때 새 버전을 안내합니다.
어느 쪽으로 설치했든 StudioRaming > MingToon > Update로 MingToon 업데이트 창을 열 수 있습니다.
창을 열면 최신 정보를 자동으로 조회하고 현재 버전과 후보 버전을 보여 줍니다.
버튼은 업데이트하기 하나입니다. 설치 가능한 후보가 있을 때 활성화되며, 실패한 설치의 상태 확인이나 재조회도 같은 버튼으로 진행합니다.
설정된 배포 경로와 설치 상태에 따라 후보가 달라집니다. 설치한 개발·프리뷰 버전보다 낮은 버전을 새 업데이트로 안내하지 않습니다.
변경사항은 MingToon Inspector에서 고른 언어의 본문만 보여 주며, 제목·목록·강조·코드·링크를 Markdown으로 표시합니다.
업데이트 전 Unity 프로젝트를 백업하세요. 베타에서는 UI·기능·룩이 바뀔 수 있으므로, 업데이트 뒤에는 남겨 둔 원본 소재로 복사본을 다시 변환하는 것을 권장합니다. 기존 복사본을 곧바로 지우지 말고 새 결과와 비교하세요. 업로드한 아바타에 반영하려면 다시 업로드해야 합니다.
3. 첫 컴파일이 끝날 때까지 기다립니다
MingToon을 처음 넣거나 새 버전으로 올리면 Unity가 스크립트를 다시 컴파일합니다. 그 뒤 MingToon이 현재 환경에서 첫 화면에 필요한 셰이더 조합을 미리 준비합니다. 이 준비는 모든 광원·그림자·인스턴싱·업로드용 변형을 전부 컴파일하는 것은 아닙니다.
- 신규 설치와 업데이트 모두 화면 앞에 MingToon 워밍업 진행 바가 뜹니다. 에디터는 계속 응답하고, 준비된 캐시는 건너뜁니다.
Cancel은 바만 닫고, 남은 준비는 오른쪽 아래 Background Tasks에서 계속됩니다. - 진행이 끝나면 재질을 엽니다. 준비 범위 밖의 조합은 처음 그릴 때 추가 컴파일될 수 있습니다.
이 작업이 시작되는 때는 셋 중 하나입니다.
- 이 프로젝트에 MingToon 컴파일 기록이 없을 때. 처음 넣었을 때, 그리고
Library폴더를 지웠을 때입니다 - 이름에
MingToon이 들어간.unitypackage임포트가 끝났을 때. BOOTH 설치기 경로입니다 - VCC(VPM)로 MingToon 패키지가 새로 들어오거나 버전이 바뀌어 Unity가 패키지 등록을 마쳤을 때. 0.1.12에서 추가된 경로입니다
컴파일 기록은 프로젝트의 Library/StudioRaming/MingToon.warmup 파일에 남습니다.
유효한 기록과 Unity의 실제 패스 캐시를 확인해 이미 준비된 조합은 컴파일 요청을 건너뜁니다.
기록은 셰이더 소스·Unity 버전·그래픽스 API 등의 조건이 맞아야 합니다. 소스가 바뀌었거나 실제 패스가 준비되지 않았으면 필요한 조합을 다시 준비합니다.
이 캐시는 현재 프로젝트에 적용되며, 다른 PC나 새 프로젝트의 첫 컴파일까지 없애지 않습니다.
진행 바의 Cancel은 바만 닫습니다. 컴파일은 Unity의 Progress 항목으로 옮겨 가 계속되고, 진행과 취소는 에디터 오른쪽 아래 상태 표시줄에서 봅니다. 거기서 취소하면 그때까지 끝낸 것은 기록으로 남습니다. 남은 변형은 그 셰이더를 처음 그리는 순간 Unity가 컴파일하므로 에디터가 잠깐 멈출 수 있습니다.
컴파일 시간은 PC와 Unity의 셰이더 컴파일러 수에 따라 크게 달라서 이 문서는 시간을 적지 않습니다. 개발본의 캐시 검증과 공개 패키지의 신규 설치·업데이트 검증은 서로 다른 단계입니다. 컴파일이 전혀 없거나 첫 설치 시간이 특정 비율로 줄어든다고 약속하지 않습니다.
4. 셰이더가 들어왔는지 봅니다
재질 하나를 고르고 Inspector 맨 위의 셰이더 목록을 엽니다.
StudioRaming/MingToon/MingToon BRP가 보이면 정상입니다.
URP 셰이더는 이번 BRP 오픈 베타에 들어 있지 않습니다.
5. VRChat 연동을 확인합니다
VRChat 대상만 해당합니다. 리로드가 끝난 뒤 Console에 아래 줄이 있어야 합니다.
[MingToon] VRChat build hook compiled and registered.
VRChat 빌드 훅이 없는 상태입니다. 업로드해도 자동 최적화가 걸리지 않습니다.
6. 프로젝트를 검증합니다
메뉴에서 StudioRaming > MingToon > Validate Project를 실행합니다.
빌드 타깃이 셰이더 모델 4.5를 못 맞추면 MING-ENV-BUILD-TARGET 오류가 납니다.
그 상태로 진행하면 재질이 마젠타(분홍색)로 나옵니다.
에디터가 2021.3이고 VRC SDK가 있으면 MING-VRC-UNITY-VERSION 경고가 뜹니다.
잘 됐는지 확인
- Console에 빨간 오류가 없습니다.
- 셰이더 목록에
StudioRaming/MingToon/MingToon BRP가 있습니다. - VRChat 대상이면 빌드 훅 로그가 찍혀 있습니다.
Validate Project결과에 오류가 없습니다.
넷 중 하나라도 어긋나면 문제 해결로 가세요.
이전 버전에서 올라왔다면
0.1.11에서 업데이트 시작 중 「바꿀 파일을 제거할 수 없습니다」가 표시되면 구버전 업데이트 오류 안내를 따라 상태를 확인한 뒤 재시도하세요. 같은 오류가 계속되면 반복 설치하지 마세요.
업데이트 직후에는 위 첫 컴파일 진행 바가 다시 나올 수 있습니다. 이미 Manager가 붙은 아바타는 업데이트해도 변환 마법사가 저절로 열리지 않습니다. 베이크 캐시가 한 번 다시 만들어집니다. 손으로 지울 것은 없고, 다음 빌드나 업로드가 그만큼 오래 걸립니다. VRChat 아바타는 다시 올려야 이번 버전이 반영됩니다. 셰이더가 아바타에 같이 실리기 때문입니다. 조건은 VRChat에 있습니다.
선택 사항: Post Processing Stack v2
MingToon은 PPv2 없이도 완전히 동작합니다. 씬 확인과 촬영용입니다.
- PPv2 3.4.0을 설치합니다.
- Player Settings > Scripting Define Symbols에
UNITY_POST_PROCESSING_STACK_V2를 직접 추가합니다. - Unity가 재컴파일을 마칠 때까지 기다립니다.
StudioRaming > MingToon > Create or Repair BRP PPv2 Global Volume을 실행합니다.
2번을 건너뛰면 4번 메뉴가 아무 일도 하지 않습니다.