동작 환경
지원 Unity 버전
| Unity | 동작 확인한 버전 | VRChat SDK | 지원 상태 |
|---|---|---|---|
| 2022.3 LTS (권장) | 2022.3.22f1 | com.vrchat.base 3.10.x | ✅ 모든 기능 (VRChat 권장 환경) |
| Unity 6 (6000.0 LTS) | 6000.0.60f1 | com.vrchat.base 3.10.x | ✅ 모든 기능 |
| 2021.3 LTS | 2021.3.45f2 | 없음 (2021용 VRChat SDK는 존재하지 않습니다) | ✅ SDK 없는 구성으로 동작 확인. Harmony를 별도 패키지로 도입하면 모든 기능, 넣지 않으면 Harmony 의존 기능은 비활성화 (아래 "VRChat SDK가 없는 프로젝트") |
| 2019.4 | 2019.4.31f1 | com.vrchat.base 3.4.0〜3.4.2 | ✅ 일부 기능을 제외하고 지원 (아래 "Unity 2019.4에서의 제한") |
| 그 외 (2020.x, 2022.1〜2022.2, 6000.1 이후 등) | — | — | 미확인 |
의존 패키지
| 항목 | 버전 |
|---|---|
| VRChat SDK Base (VPM에서는 필수) | com.vrchat.base 3.4.0 이상 (2022.3 / Unity 6에서는 3.10.x, 2019.4에서는 3.4.0〜3.4.2. Harmony가 포함되는 것은 3.4.0부터) |
| VRChat SDK Avatars (선택) | 3.x — 아바타 전용 기능을 활성화 |
| VRChat SDK Worlds (선택) | 3.x — 월드 전용 기능을 활성화 |
| Modular Avatar (선택) | 1.16 이상 (MA 관련 도구용) |
필수 의존성은 com.vrchat.base만
Base에 포함된 Harmony를 대부분의 기능이 사용하기 때문에 필수입니다. Avatars / Worlds / Modular Avatar는 해당 기능을 사용할 때만 있으면 됩니다.
VRChat SDK가 없는 프로젝트 (Unity 2021 등)
Base가 없는 프로젝트에서도 컴파일 오류는 나지 않으며, 그대로라면 Harmony에 의존하지 않는 기능만 활성화됩니다 (Unity 2021.3.45f2에서 동작 확인). VPM의 의존성 해결로 SDK가 설치되어 버리므로, .unitypackage를 임포트하거나 패키지 폴더를 Packages/net.satania.customeditors에 복사 (Embedded)해서 도입하세요.
Harmony만 별도 패키지로 도입하면 모든 기능을 사용할 수 있습니다. SCE가 "SDK도 Harmony도 없음"을 감지하면 시작 시 안내를 표시하고, Editor Setting 맨 위에도 도입 버튼이 나옵니다 (본가 Lib.Harmony의 0Harmony.dll을 그대로 net.satania.harmony 패키지로 만든 것. MIT, Editor 전용. Packages/net.satania.harmony에 Embedded로 들어갑니다). 도입 경로는 2가지:
- 다운로드하여 도입 (권장): SCE의 배포 사이트 (Cloudflare Pages, VPM 리스트와 같은 위치)에서 최신 버전을 받아 SHA256을 확인한 뒤 풉니다
- 포함된 복사본으로 도입: SCE에 포함된 Harmony 2.4.2를 써냅니다. 네트워크 불필요
나중에 VRChat SDK (3.4.0 이상)를 넣으면 SDK에 포함된 Harmony와 중복되므로, SCE가 시작 시 net.satania.harmony를 자동으로 제거합니다 (SDK와 동시에 넣은 신규 프로젝트만 Packages/net.satania.harmony를 직접 삭제해 주세요).
- 비활성화되는 기능 (Harmony를 도입하지 않은 경우): Animator 창 확장 (파라미터 색 구분, Condition 오버레이, Transition 복사 & 붙여넣기, 노드 스타일 등) / Inspector 확장 (컴포넌트 헤더 버튼, Debug 전환, Transform 대칭 편집 등) / SkinnedMeshRenderer의 BlendShape 확장 / 창 배경 (Console・Project・Hierarchy) / 에디터 테마 / DockArea 확장 / GameView 스크린샷 / VRCExpressionsMenu 값 표시. Editor Setting의 해당 페이지도 표시되지 않습니다
- 사용할 수 있는 기능: Hierarchy 확장 (컴포넌트 아이콘, 색상 마킹, EditorOnly 시각화와 전환) / Project 폴더 아이콘 / 사타니아 편리 도구 / AnimationClip 계열 도구 (Binding Checker, Loop Maker, Path Editor, Splitter, Breath Animation Builder) / RichText Builder / 표정 아이콘 촬영 / AnimatorController DSL / 기믹 번들 (Avatars에 의존하는 Menu・Parameters 제외) / Texture2DArray / Light Probe Generator / 그 외 단독 도구. Unity 2022.1 이상이면 New Hierarchy・Asset Reference Tree・Package Manager 즐겨찾기・SceneView MSAA / 선택 아웃라인도, 2022.2 이상이면 Inspector 배경도 사용할 수 있습니다
macOS (Apple Silicon)에서는 추가 패키지가 필요합니다
Apple Silicon Mac에서는 VRChat SDK에 포함된 Harmony (0Harmony 2.0.5)가 macOS의 메모리 보호 (W^X)에 대응하지 않아, SCE / Modular Avatar / NDMF의 Harmony 패치가 모두 mprotect returned EACCES로 실패합니다. anatawa12 님의 Harmony Patches for Apple Silicon (native & Rosetta) (com.anatawa12.apple-silicon-harmony, VPM 저장소 https://vpm.anatawa12.com/vpm.json)를 설치하면 해결됩니다. SCE는 이 실패를 감지하면 시작 시 설치를 제안하는 대화 상자를 표시합니다 (Editor Setting의 BugFix 항목에서도 설치할 수 있습니다).
Unity 2019.4에서의 제한
Unity 2019.4 (2019.4.31f1에서 확인)에도 설치할 수 있지만, Unity 쪽 API가 없기 때문에 다음 기능은 사용할 수 없습니다 (메뉴나 설정에도 표시되지 않습니다): New Hierarchy 창 / Asset Reference Tree / SceneView MSAA / SceneView 선택 아웃라인 (Custom) / Package Manager 즐겨찾기 탭 / Properties 창을 여는 버튼류 (2019에는 Properties 창이 없음) / VRCExpressionsMenu 값 표시 (SDK 3.7.0 이후의 타입에 의존). RichText Builder의 그라데이션 복사 & 붙여넣기도 사용할 수 없습니다. VRChat SDK는 2019.4용 최종 버전인 3.4.0〜3.4.2를 사용하세요 (3.2 / 3.3에는 Harmony가 없으므로 Harmony 패치 계열 기능이 비활성화됩니다).
기능 게이트 (#define)에 대하여
의존 패키지의 유무에 따라 asmdef의 versionDefines로 기능이 자동 전환됩니다:
| 심볼 | 조건 | 활성화되는 기능 |
|---|---|---|
SCE_SDK_BASE_AND_HARMONY | com.vrchat.base 3.4.0 이상 (0Harmony 포함 버전) | 거의 모든 Harmony 패치 계열 기능 (필수) |
SCE_SDK_AVATARS | com.vrchat.avatars 3.x | Int 압축 레이어 / VRC 템플릿 등 |
SCE_SDK_AVATARS_3_6_OR_NEWER | com.vrchat.avatars 3.6.0 이상 | 파라미터 사용 위치 검색에서의 VRC_AnimatorPlayAudio 대응 |
SCE_SDK_AVATARS_3_7_OR_NEWER | com.vrchat.avatars 3.7.0 이상 | VRCExpressionsMenu 값 표시 (ExpressionsControlField에 의존), 기믹 번들의 메뉴 Parameters 출력 |
SCE_SDK_BASE_3_10_OR_NEWER | com.vrchat.base 3.10.2 이상 | AnimDsl의 Parameter Driver preventRepeats |
SCE_SDK_WORLDS | com.vrchat.worlds 3.x | SerializedUdonPrograms 정리 등 |
SCE_MODULAR_AVATAR | Modular Avatar 1.16+ | MA Parameters 비트 수 분류 등 |
SCE_NEWTONSOFT_JSON | com.unity.nuget.newtonsoft-json | AnimatorController DSL의 Import |