VRChat User Guide

💡안내: 본 가이드는 VRChat 공식 권장 방법을 따릅니다.

시작 전 준비 사항

• VRChat 아바타 제작을 시작하기 전에 다음 프로그램과 파일을 준비해주세요.

계정 준비

VRChat 계정

• VRChat 웹사이트(https://vrchat.com) 에서 무료 계정 생성
• 아바타를 업로드하고 VRChat에서 사용하기 위해 필요합니다.

💡아바타 업로드 조건 (Trust Rank)
- 아바타를 업로드하려면 VRChat에서 "New User" Trust Rank 이상이어야 합니다.
- "New User" 등급 도달을 위해서는 VRChat에서 일정시간 플레이가 필요하며 신규 계정(Visitor)은 아바타 업로드가 불가능합니다.

Trust Rank에 대한 자세한 내용은 아래 페이지를 참고하세요:
- 아바타 제작 요구사항: https://creators.vrchat.com/avatars/creating-your-first-avatar/#requirements
- Trust & Safety 시스템: https://docs.vrchat.com/docs/vrchat-safety-and-trust-system#trust-rank
- 자주 묻는 질문 (FAQ): https://docs.vrchat.com/docs/frequently-asked-questions

Unity 계정

• Unity 웹사이트(https://unity.com) 에서 무료 계정 생성
• Unity Hub와 Unity 에디터를 사용하기 위해 필요합니다.

💡가이드 진행 전에 두 계정을 모두 미리 만들어 두시는 것을 권장합니다.

필수 프로그램

• VRChat Creator Companion (VCC)

  • VRChat 아바타 제작을 위한 공식 도구입니다.
  • 다운로드: VRChat Creator Companion 공식 페이지
    • 아래 사각형 부분을 클릭하여 다운로드 합니다.
    • 시스템 요구사항
      • Windows 10 (64비트) 또는 Windows 11 (64비트)

      • ⚠️Mac과 Linux는 완벽하게 지원되지 않습니다.

   

• Unity Hub와 Unity
  • Unity Hub와 Unity가 설치되어 있어야 합니다.
  • VCC를 실행하면 설치 여부를 확인합니다.
    • 이때, Unity Hub 없으면 설치 안내가 나타나며, 사용자가 직접 설치해야 합니다.
  • Unity Hub 설치 및 로그인 후, VCC가 VRChat과 호환되는 Unity 버전(2022.3.22f1)을 자동으로 설치합니다.

⚠️참고: Unity Hub에서 다른 Unity 버전을 권장하는 메시지가 표시될 수 있으나, 무시하고 VCC가 설치한 버전(2022.3.22f1)을 사용하세요.

필수 에셋 설치

다음 에셋들을 미리 다운로드 받아주세요:

1. 릴툰 쉐이더 (lilToon Shader)
   • 아바타의 외형을 표현하는 쉐이더입니다.
   • 다운로드:
     • 공식 웹사이트: https://lilxyzw.github.io/lilToon/
     • GitHub 다운로드: https://github.com/lilxyzw/lilToon/releases
   • 설치 방법:
     1. 공식 웹사이트에서 "Add to VCC" 또는 "VCCに追加" 버튼을 클릭합니다.
     2. VCC 프로그램이 자동으로 실행되고 repository 추가 확인 창이 나타납니다.
     3. 확인 창에서 "Add" 또는 "확인" 버튼을 클릭하여 추가를 완료합니다.
2. 모듈러 아바타 (Modular Avatar)
   • 아바타 의상 교체를 쉽게 해주는 도구입니다.
   • 다운로드: Modular Avatar Documentation
   • 설치 방법:
     1. 공식 웹사이트에서 "Add to VCC" 버튼을 클릭합니다.
     2. VCC 프로그램이 자동으로 실행되고 repository 추가 확인 창이 나타납니다.
     3. 확인 창에서 "Add" 또는 "확인" 버튼을 클릭하여 추가를 완료합니다.

💡참고: Repository는 한 번만 추가하면 모든 프로젝트에서 사용할 수 있습니다.

1. ZIP 파일 다운로드

1. CONNECT에서 원하는 의상을 선택합니다.
2. 다운로드 버튼을 클릭합니다.
   • 다운로드가 완료되면 파일이 자동으로 컴퓨터의 다운로드 폴더에 저장 됩니다.

2. ZIP 파일 압축 해제

2-1. 압축 풀기

1. 다운로드 받은 .zip 파일을 우클릭한 후 [압축 풀기] 를 클릭합니다.
2. 원하는 폴더에 압축을 풀어줍니다.

2-2. 압축 해제 확인

1. 압축이 완료되면 새로 생성된 폴더를 더블 클릭하여 엽니다.
2. 폴더 안에 다음 파일들이 있는지 확인합니다:
   • FBX 폴더
   • Textures 폴더
   • .unitypackage 파일

3. VCC로 프로젝트 생성

⚠️기존 VRChat 사용자이신가요?
- 이미 VCC와 Unity가 설치되어 있다면 3-1, 3-2 단계를 건너뛰고 바로 3-3 단계로 진행하세요.

3-1. VRChat Creator Companion (VCC) 실행 및 Unity 설치

1. VRChat Creator Companion (VCC)을 실행합니다.
   • 처음 실행 시 VCC가 자동으로 Unity Hub 설치 여부를 확인합니다.
   • Unity Hub가 설치되어 있지 않다면 설치 안내가 나타납니다.
   • 안내에 따라 Unity Hub를 먼저 설치합니다.
2. Unity Hub를 실행하고 Unity 계정으로 로그인합니다.
3. 로그인 후, VCC가 자동으로 VRChat과 호환되는 Unity 버전(2022.3.22f1)을 설치합니다.
4. 모든 설치가 완료될 때까지 기다립니다. (약 10~20분 소요)

⚠️중요: Unity Hub에서 다른 Unity 버전 설치를 권장하는 메시지가 나타날 수 있습니다. 이 메시지는 무시하셔도 됩니다.

3-2. 새 프로젝트 생성

1. VRChat Creator Companion (VCC) 좌측 메뉴에서 "Projects" 탭을 클릭합니다.                                                                                                                                                                    
2. 우측 상단의 "Create New Project" 버튼을 클릭합니다.
3. 프로젝트 템플릿 선택 화면에서 "Avatar"를 선택합니다. (⚠️ "World"가 아닙니다!)
4. 프로젝트 이름을 입력합니다. (예: "MyAvatarProject")
5. 프로젝트 저장 위치를 선택합니다.
6. "Create Project" 버튼을 클릭합니다.

3-3. 필수 패키지 설치

프로젝트 생성 후, 아바타 제작에 필요한 패키지들을 설치합니다:

1. VRChat Creator Companion (VCC) 좌측 메뉴에서 "Projects" 탭을 클릭합니다.                                                                                                                                                    
2. 생성된 프로젝트 옆의 "Manage Project" 버튼을 클릭합니다.
3. Manage Packages 목록에서 다음 패키지들을 설치합니다:
   • VRChat SDK - Avatars (자동으로 포함되어 있는지 확인)
     • 반드시 VRChat SDK 3.9.0 이상 버전을 사용해주세요. (VCC에서 최신 버전 자동 설치 권장)
     • VRChat SDK 3.9.0 이하 버전을 사용할 경우 아이템 빌드가 실패할 수 있습니다.             
   • Modular Avatar (다운로드 받은 파일 또는 VCC 목록에서 설치)
   • lilToon - 아바타의 외형을 표현하는 쉐이더
4. 각 패키지 옆의 "+" 또는 "Install" 버튼을 클릭하여 설치합니다.

💡 패키지가 목록에 보이지 않는 경우

• 우측 상단의 "Selected Repos" 드롭다운을 클릭합니다.
• Community Repositories 섹션에서:
  • "bd_" 체크 (Modular Avatar가 보이지 않는 경우)
  • "lilxyzw" 체크 (lilToon이 보이지 않는 경우)                                                                                                   

3-4. Unity 프로젝트 열기

1. 모든 패키지 설치가 완료되면 "Open Project" 버튼을 클릭합니다.
2. Unity 에디터가 자동으로 실행됩니다.
3. 프로젝트가 로딩될 때까지 기다립니다.

⏱️참고: Unity가 처음 프로젝트를 열 때는 5~10분 정도 소요될 수 있습니다.

4. 아바타 설정 및 업로드

4-1. 유니티 패키지 임포트

1. Unity 상단 메뉴에서 Assets → Import Package → Custom Package를 선택합니다.                                                               
2. 압축 해제한 폴더에서 .unitypackage 파일을 선택합니다.
3. Import 창이 나타나면 모든 항목이 체크되어 있는지 확인합니다.
4. "Import" 버튼을 클릭합니다.

💡Tip: .unitypackage 파일을 Assets 폴더로 직접 드래그 앤 드롭할 수도 있습니다.

4-2. 아바타 프리팹 (Prefab)을 씬 (Scene)에 배치

1. Unity 하단의 Project 창을 확인합니다.
2. Assets → [의상 이름 폴더] → Prefab 폴더 순서로 엽니다.                                                                                    
3. Prefab 폴더 안의 아바타 프리팹 파일을 찾습니다
4. 프리팹 (Prefab) 을 Hierarchy 창으로 드래그 앤 드롭합니다.                                                                                                       
5. 씬을 저장합니다. (Ctrl + S 또는 File → Save)

4-3. VRChat SDK 패널 열기

1. Unity 상단 메뉴에서 VRChat SDK → Show Control Panel을 클릭합니다.
2. VRChat SDK 패널이 화면에 나타납니다.
3. "Authentication" 탭에서 VRChat 계정으로 로그인합니다.                                                                                                    

4-4. 아바타 정보 입력

VRChat SDK 패널의 "Builder" 탭에서:

1. Selected Avatar
   • 업로드할 아바타 오브젝트가 선택되어 있는지 확인
2. Name (아바타 이름) - 필수
   • 아바타를 식별할 이름을 입력합니다.
   • 예: "VRC_CONNECT_030"
3. Visibility (공개 설정) - 필수
   • Private: 본인만 사용 가능

   • Public: 모든 사용자가 복제 가능

     ⚠️주의: Public 설정 시 누구나 복사 가능

4. Content Warnings (콘텐츠 경고) - 선택 사항
   • 민감한 콘텐츠 포함 시 체크
   • 예: Violence, Horror 등
5. Description (설명) - 선택 사항
   • 아바타에 대한 간단한 설명을 입력합니다.
6. 썸네일 설정 - 필수
   • 준비된 이미지가 있는 경우:
     • "Select Image" 버튼 클릭 → 이미지 파일 선택
   • Unity에서 직접 촬영:
     1. "Capture In Scene" 버튼 클릭
     2. Scene 뷰에서 마우스로 아바타 각도 조정
        • Alt + 좌클릭 드래그: 회전
        • 마우스 휠: 줌
        • F 키: 아바타에 포커스
     3. 오른쪽 미리보기에서 실시간 확인
     4. "Capture" 버튼 클릭
        • 💡캡처 옵션 (선택 사항):
          • Fill Background: 배경을 단색으로 채움
          • Use PostProcessing: 후처리 효과 적용
          • Use Custom Camera: 특정 카메라 시점 사용                                                                                                          

4-5. 빌드 전 검증 (Review Any Alerts)

빌드를 진행하기 전에 VRChat SDK의 "Review Any Alerts"의 이슈를 확인합니다.

⚠️참고 사항
- VRChat SDK의 알림(Validation 메시지)은 일부는 필수, 일부는 선택 사항입니다.
- 모든 이슈를 반드시 해결해야 빌드가 가능한 것은 아닙니다.

권장 처리 방법

1단계: Auto Fix 버튼이 있는 이슈

• Auto Fix 버튼이 표시된 이슈는 SDK가 자동으로 수정 가능하다고 판단한 것입니다.
• Auto Fix 버튼을 클릭하여 자동 수정을 진행합니다.

2단계: Select 버튼만 있는 이슈

• 이슈 내용을 읽고 필요에 따라 판단합니다.
• 대부분의 경우 빌드는 가능하지만, 최적화나 기능 개선을 위해 참고하세요.

4-6. 아바타 빌드 및 업로드

1. "3. Build" 섹션으로 이동합니다.                                                                                                                                                                                       
2. Build Type 선택
   • "Build & Publish Your Avatar Online" 선택
   • 아바타를 VRChat 서버에 업로드하여 게임에서 사용 가능하게 됩니다.
3. Platform 선택
   1. Windows: PC용 VRChat에서 사용

   2. Android: Quest/모바일용 VRChat에서 사용

      ⚠️CONNECT의 파일은 PC (Windows) 플랫폼 전용이므로 빌드 시 Windows를 선택하세요. Quest/Mobile 플랫폼은 공식적으로 지원되지 않습니다.
      관련 참고 페이지:
      - Avatar Impostor: https://creators.vrchat.com/avatars/avatar-impostors/
      - Quest Content Optimization: https://creators.vrchat.com/platforms/android/quest-content-optimization

4. 이용약관 동의
   • 하단의 체크박스를 확인합니다.
     • "The information provided above is accurate and I have the rights to upload this content to VRChat."
5. "Build & Publish" 버튼 클릭
   • Unity가 아바타를 빌드하고 자동으로 업로드합니다.

   • 빌드에는 수 분이 소요될 수 있습니다.

     ✅ 빌드 성공 시:
     - 빌드 및 업로드 완료 메시지가 표시됩니다.
     - VRChat 게임 실행 후 Avatars 메뉴에서 아바타를 착용할 수 있습니다.
     
     ❌ 빌드 실패 시:
     - Unity Console 창(Window > General > Console)에서 에러 메시지 확인
     - 해결하지 않은 알림이 있는지 확인 (⚠️4-5. 빌드 전 검증)
     - 문제 해결 후 다시 "Build & Publish" 버튼 클릭

📖 자세한 내용은 VRChat 공식 문서를 참고하세요:
- [Creating Your First Avatar - Step 6]
- [SDK Troubleshooting]

5. VRChat에서 아바타 확인

5-1. VRChat 실행

1. Steam에서 VRChat을 실행합니다.
2. 로그인 후 게임에 접속합니다. 

5-2. 아바타 착용

1. 메인 메뉴를 엽니다. (ESC 키 또는 컨트롤러 메뉴 버튼)
2. Avatars 메뉴를 선택합니다.                                                                                                                                                                            
3. Uploaded 탭에서 방금 업로드한 아바타를 선택하고 Apply를 눌러 아바타를 착용합니다.                                                                

5-3. 아바타와 함께 VRChat 즐기기

축하합니다! 아바타 적용이 완료되었습니다.

이제 새로운 아바타와 함께 VRChat 세계를 자유롭게 탐험하고 즐겨보세요!

💡 추가 도움이 필요하신가요?

• VRChat 공식 문서: https://docs.vrchat.com
• lilToon 공식 문서: https://lilxyzw.github.io/lilToon/
• Modular Avatar 공식 문서: https://modular-avatar.nadena.dev
• VRChat 아바타 생성 공식 문서: https://creators.vrchat.com/avatars