n72 Avatar
Toolkit

사용 환경

구매 · 설치 전에 프로젝트 환경과 사용하려는 기능에 필요한 패키지를 확인해 주세요.

설치

처음 설치할 때만 BOOTH에서 구매 · 다운로드한 판매 패키지를 Unity 프로젝트에 가져옵니다. 이후 업데이트는 Unity 안에서 진행할 수 있습니다.

기본 조작

먼저 Hierarchy에 있는 작업 대상 Avatar를 선택하고 Home에서 필요한 기능으로 이동합니다.

메뉴 관리

Avatar의 Expression Menu를 읽고 여러 Menu를 정리 · 통합합니다. 통합 후에도 개별 해제와 복원이 가능하도록 설계되어 있습니다.

기본 사용법

1. 대상 Avatar 지정: Hierarchy의 Avatar Root를 지정합니다.
2. Menu 읽기: 감지된 Menu와 Parameter 상태를 확인합니다.
3. 통합할 Menu 선택: 원하는 Menu를 선택하고 필요하면 계층과 표시 위치를 조정합니다.
4. 적용: 오류가 없는지 확인하고 통합합니다. 같은 화면에서 해제 · 복원도 할 수 있습니다.

Material 조정

기준 Material에서 필요한 설정을 선택해 대상 Material에 적용합니다. 지원하지 않는 설정은 자동으로 건너뜁니다.

1. 기준 Material 지정: 복사 원본으로 사용할 Material을 선택합니다.
2. 적용할 설정 선택: 색상만, 그림자만 등 필요한 항목을 선택할 수 있습니다.
3. 적용할 Material 선택: 목록에서 변경할 Material을 체크합니다.
4. 적용: 기준 Material 자체에는 적용되지 않으며 지원하지 않는 항목은 자동으로 건너뜁니다.

Texture 조정

대상 Avatar가 사용하는 Texture를 목록으로 표시하고 Import Settings의 Max Size를 일괄 변경할 수 있습니다.

1. Texture 목록 갱신: 대상 Avatar가 사용하는 Texture를 읽습니다.
2. 변경할 Texture 선택: 개별 선택 또는 전체 선택을 사용합니다.
3. 변경 후 Max Size 지정: 일괄 지정과 Texture별 개별 지정이 가능합니다.
4. 변경 적용: 원본 이미지 파일은 변경하지 않고 Import Settings만 변경해 경량화를 돕습니다.

토글 생성

Object 또는 Material 전환 Toggle을 만들고 Animation · Animator · Expressions Menu까지 자동 생성합니다.

1. Toggle 기능 선택: 표시 / 숨기기, Object 전환 A/B, Material 전환 A/B 중 선택합니다.
2. 대상 Object / Material 지정: Hierarchy에서 대상을 드래그해 설정합니다.
3. 메뉴 표시 이름 · 초기 상태 설정: VRChat에서 보일 이름과 초기 상태를 정합니다.
4. 생성: Animation Clip, FX용 Animator Controller, MA Merge Animator, Menu Item / Installer, Bool Parameter를 자동 생성합니다.

성능 확인

업로드 전에 Texture · Material Slots · PhysBone · Particle · Light 등 주요 성능 부담 요소를 한 번에 확인합니다. 수가 많은 항목을 찾아 아바타를 경량화할 때 어디부터 살펴볼지 판단하는 참고 자료로 사용할 수 있습니다.

아바타 관리

수정한 Avatar를 Library에 보관해 Hierarchy를 정리합니다. 의상이나 수정 내용이 다른 Avatar를 목록으로 관리하고, 필요할 때만 Hierarchy로 되돌릴 수 있습니다.

Avatar 보관

현재 Avatar 구성을 Prefab으로 저장하고 필요하면 Hierarchy에서 잠시 치울 수 있습니다.

썸네일 관리

보관할 때 썸네일 설정 화면이 열립니다. 현재 SceneView를 촬영하거나 PNG / JPG 이미지를 선택합니다. 이미지는 Library 표시용으로 경량화해 저장합니다.

목록과 Hierarchy 구성

Library 상단의 가로 스크롤 목록에서 Avatar를 선택합니다. 이름 · Blueprint ID · 저장 일시와 Hierarchy 트리를 확인하고 필요한 계층만 펼칠 수 있습니다.

되돌리기 / 복제해서 되돌리기

「Hierarchyへ戻す」는 Library에서 꺼내 복원하고, 「複製して戻す」는 Library에 남긴 채 Hierarchy에 복사합니다.

Blueprint ID 관리

복제할 때 Blueprint ID를 유지할지, ID를 제거해 새 Avatar로 다룰지 선택할 수 있습니다.

분류 / 폴더

보관한 Avatar를 분류별로 정리합니다. 전체 · 미분류는 항상 존재합니다. ＋로 분류를 추가하고 Avatar 썸네일을 오른쪽 클릭해 분류를 변경할 수 있습니다.

Missing Script 확인

보관 전에 Avatar의 Missing Script를 감지해 경고합니다. 대상 Object 목록에서 Hierarchy 위치와 누락 개수를 확인합니다.

기본 사용법

1. Hierarchy의 Avatar Root를 지정합니다.
2. 「現在のAvatarを保管」를 누릅니다.
3. 표시된 화면에서 현재 SceneView를 촬영하거나 이미지를 선택합니다.
4. Library에 저장합니다. 필요하면 현재 Avatar를 Hierarchy에서 치웁니다.
5. 필요할 때 「Hierarchyへ戻す」 또는 「複製して戻す」로 Hierarchy에 펼칩니다.

되돌리는 방법의 차이

「Hierarchyへ戻す」는 Avatar를 Library에서 꺼내므로 Library 등록이 사라집니다. 「複製して戻す」는 Library에 보관한 채 Hierarchy에 복사본을 만듭니다. 복제할 때 Blueprint ID를 유지할지 새 Avatar로 다룰지 선택합니다.

분류 관리

분류 이름을 변경하거나 삭제할 수 있습니다. 분류를 삭제해도 Avatar 자체는 삭제되지 않고 미분류로 이동합니다.

Missing Script가 발견되면

목록에서 대상 Object를 선택하고 Inspector의 Missing (Mono Script)를 확인합니다. 불필요하면 Missing Script를 삭제하고, 필요하면 Package / Script를 복원한 다음 보관합니다.

Blueprint ID 주의

같은 Blueprint ID를 유지한 Avatar를 Upload하면 기존 Avatar를 덮어쓸 수 있습니다. 별도 Avatar로 공개할 경우 복제할 때 새 Avatar로 다루는 설정을 선택해 주세요.

에셋 관리

Project / Hierarchy의 Asset을 라벨 · NEW 표시 · 썸네일로 찾기 쉽게 정리합니다.

Project / Hierarchy 라벨 관리

Project의 Asset · 폴더뿐 아니라 Hierarchy의 GameObject에도 프리셋 · 사용자 지정 라벨을 설정합니다. 부모 폴더가 상점 이름이면 상품 폴더 등 설정 가능한 계층에서 관리해 주세요.

NEW 표시

Package Import 후 새 부모 폴더나 상품 단위를 NEW 표시로 찾기 쉽게 합니다.

썸네일

상품 페이지 URL에서 썸네일을 등록해 폴더만 보고도 내용을 구분하기 쉽게 합니다.

같은 상점의 상품

같은 상점의 여러 상품도 각각 표시 · 관리할 수 있습니다.

이동 · 이름 변경 추적

Asset 이동이나 이름 변경 후에도 정리 정보가 따라갑니다.

Project에서 라벨 설정

1. Home에서 Organizer의 라벨 관리 화면을 엽니다.
2. 상품 · Asset에 라벨, NEW 표시, 썸네일 등 필요한 정보를 설정합니다.
3. Project / Hierarchy에서 확인합니다. 평소 수정 작업 중 목록에서 찾기 쉬워집니다.

Hierarchy에서 라벨 설정

Hierarchy의 GameObject를 약 1초간 길게 누르면 라벨을 설정할 수 있습니다. 일반 클릭은 선택, 드래그는 이동에 사용할 수 있습니다.

1. Hierarchy에서 라벨을 붙일 GameObject를 찾습니다.
2. 왼쪽 클릭으로 약 1초간 길게 누르면 라벨 설정 Popup이 열립니다.
3. 프리셋 또는 사용자 지정 라벨을 선택합니다. 변경할 때도 GameObject를 길게 누릅니다.
4. 설정한 작은 색상 라벨이 GameObject 이름 바로 뒤에 표시되는지 확인합니다.

조작과 표시

드래그를 시작하면 길게 누르기 판정은 취소됩니다. 오른쪽 클릭 메뉴에서도 라벨을 설정할 수 있습니다. 이름이 길어 오른쪽 다른 도구 표시와 겹치면 라벨을 표시하지 않습니다. 라벨 자체를 클릭하는 것이 아니라 GameObject를 길게 눌러 설정 · 변경합니다.

원본 데이터는 바뀌지 않습니다

라벨은 GameObject 이름이나 Hierarchy 구조를 변경하지 않습니다. Project 정리 조작도 실제 파일이나 폴더를 이동하지 않습니다.

업데이트 방법

처음 설치한 후에는 Unity 안에서 업데이트 확인과 적용이 끝납니다.

1. 처음 설치할 때만 BOOTH에서 구매 · 다운로드: BOOTH 상품 페이지에서 판매 패키지를 받습니다.
2. 판매 패키지 Import: 설치 절차에 따라 Unity 프로젝트에 가져옵니다.
3. Unity에서 자동 확인: Unity 시작 시와 이후 30분마다 최신 버전을 자동 확인합니다. 새 버전이 있을 때만 Toolkit 상단에 알림이 표시됩니다.
4. 업데이트 버튼 누르기: 알림의 「更新する / Update」를 누릅니다.
5. 자동 다운로드 · 적용: Toolkit이 업데이트 데이터를 받아 적용합니다. Unity 재컴파일이 끝날 때까지 기다립니다.
6. 완료: 재컴파일 후 최신 Toolkit을 사용할 수 있습니다. 업데이트 ZIP을 직접 다운로드 · 압축 해제 · 교체할 필요가 없습니다.

알림이 표시되지 않을 때

최신 버전이면 업데이트 알림 영역이 표시되지 않습니다. 가져오기에 실패했을 때만 재확인 버튼이 표시됩니다.

업데이트 시 유지되는 데이터

Avatar Library 등록 데이터, 썸네일, 분류 / 폴더 정보, Generated 데이터와 생성한 Material 등 사용자 데이터는 유지됩니다.

업데이트 전 확인

Toolkit 본체의 .cs 파일을 직접 편집했다면 최신 버전으로 덮어쓸 수 있습니다. 만일을 위해 프로젝트 백업을 권장합니다.

업데이트 이력

정식 출시 이후의 변경 사항입니다.

문제 해결

증상에 따라 확인하고, 해결되지 않으면 진단 보고서를 첨부해 지원팀에 연락해 주세요.

진단 보고서와 개별 지원

구매 후 설치 · 조작에 관한 질문이나 아바타 수정 중 발견한 이상 동작을 Discord에서 상담할 수 있습니다. 상황을 함께 확인할 수 있도록 Toolkit의 Home에서 진단 보고서를 작성해 보낼 수 있습니다.

1. Home → 진단 보고서: 「診断レポートをコピー」 또는 「診断レポートを保存」를 사용합니다.
2. 내용 확인: 사용자 이름 · PC 이름 · Project 절대 경로 · Avatar / Object / Material 이름 · URL은 기록하지 않도록 설계되어 있습니다.
3. Discord 지원으로 보내기: Home의 「Discordサポートを開く」에서 진단 보고서 · 스크린샷 · Console 오류 등을 보내 주세요.

Discord

문제나 조작에 관한 상담은 Toolkit Home의 「Discordサポートを開く」에서 지원 채널로 이동할 수 있습니다.

1. 진단 보고서 저장 또는 복사: Toolkit Home에서 가져오고 내용을 확인합니다.
2. 스크린샷과 Console 오류 준비: 증상이 보이는 화면과 오류 메시지를 첨부해 주세요.
3. Discord 지원 열기: Home 버튼으로 열고 재현 절차와 함께 보내 주세요.

자주 묻는 질문

구매 전 · 설치 · 조작 · 업데이트 · 지원에 관한 자주 묻는 질문입니다. 항목은 앞으로도 추가됩니다.

이용약관

구매 · 사용 전에 이용 가능한 범위와 금지 사항을 확인해 주세요.

사용자의 의견을 반영하며 업데이트를 이어가는 Toolkit

이름을 입력할 필요는 없습니다. 이해하기 어려웠던 부분, 이상 동작, 추가를 원하는 기능과 개선 제안을 익명으로 보낼 수 있습니다.

사용자 설문조사

n72 Avatar Toolkit을 사용한 소감이나 개선 요청이 있다면 참여해 주세요. 설문조사 참여는 선택 사항입니다.