본문으로 건너뛰기

초간단 설치 및 사용 가이드

경고

작성중입니다. 조금만 기다려주세요.

정보

본 문서는 PrismStudio 1.16hotfix1를 기반으로 작성되었습니다.

모든 내용은, 읽는이가 Unity와 VRChat 아바타에 대한 지식을 약간이라도 알고 있다는 것을 전제로 설명합니다.

시작하기 앞서...

모든것을 시작하기에 앞서, PrismStudio의 간략한 작동 방법에 대해 짚고 넘어가면 좋습니다.

PrismStudio는 외부에서 VRChat 카메라를 조종하는 방식입니다. 이를 구현하기 위해서는 2가지 기능이 필요합니다.

여기서 패치된 카메라 에셋 은, PrismStudio가 지원하는, 그리고 필요로 하는 외부 카메라 에셋 (VRCLens, VirtualLens2, Integral, FlexFishEye)을 말합니다.

이 가이드에서는, 여러분이 가지고 있는 카메라 에셋을 PrismStudio용으로 패치하는 방법과, PrismStudio Unity 프로젝트의 셋업 & 간략 사용법을 설명합니다.

PrismStudio를 구매했다!

PrismStudio를 구매한 뒤, 파일을 다운로드 받아 압축을 풀면 아래와 같은 파일들이 있습니다.

  1. PrismStudio Unity 프로젝트 폴더
  • 이 폴더는 유니티 프로젝트로써, Unity Hub를 사용하여 이 폴더를 Unity로 열 수 있습니다.
    • 이 Unity 프로젝트는 VRChat용 프로젝트가 아닌, 일반 Unity 프로젝트입니다.
  1. README.txt 파일
  • 사용전에 읽어보면 좋은 정보가 들어있습니다. 3개 언어로 번역되어있으니, 본인이 읽을 수 있는
  1. UniversalPatcher Unity 패키지 파일
  • 이 패키지 파일은, 아바타의 카메라 기믹을 PrismStudio에 대응되도록 패치해주는 유틸리티가 들어있는 패키지입니다.
  1. UpdatePackage Unity 패키지 파일
  • 이 패키지 파일은, 일반 Unity 프로젝트나 기존 PrismStudio Unity 프로젝트를 새 버전으로 업데이트해주는 패키지입니다.
  1. VirtualTrackerCreator Unity 패키지 파일
  • 이 패키지 파일은, 액터의 아바타에 VirtualTracker를 부착하는 것을 도와주는 유틸리티입니다.

아바타를 준비해보자!

PrismStudio는 현재 자체제작 카메라 에셋이 없기에, VRCLens나 VirtualLens2 등의 카메라 에셋을 필요로 합니다. 그러기 위해서는, 아바타에 카메라 기믹을 설치하고, UniversalPatcher를 사용하여 패치해야 합니다.
UniversalPatcher로 패치된 카메라 기믹은, PrismStudio가 활성화 되었을때 PrismStudio가 전송하는 수많은 데이터 (위치, 각도, 카메라 속성 등) 를 해석해서 기존 속성을 오버라이드할 수 있게 됩니다.

1. 아바타 프로젝트 준비

아바타 준비는 간단합니다.
VCC를 사용해서, 여러분이 사용하시는 아바타를 사용한다면 기존에 사용하는 아바타 프로젝트에서 Manage Project를 열고, 새로운 아바타를 만드려 한다면 VCC를 통해 새로운 아바타 프로젝트를 생성합니다.

Manage Project 버튼을 눌렀거나 새로운 프로젝트를 생성했다면 아래와 같은 인터페이스가 등장합니다:

  1. 사용 가능한 기능 리스트
  2. 현재 프로젝트에 설치된 기능
  3. 기능의 최신 버전
  4. 설치/제거
  5. 설치된 기능을 업데이트

이제 아바타 프로젝트에 Modular Avatar와 NDMF를 설치합니다. 여기를 눌러 VCC에 기능을 등록하거나 https://modular-avatar.nadena.dev/ 에서 Download (Using VCC) 버튼을 누릅니다.

부가적으로, 여기를 눌러 VCC에 릴툰 (lilToon)을 기능으로써 등록할 수 있습니다. (또는 https://lilxyzw.github.io/lilToon/ 링크에서 VCCに追加 버튼을 눌러 직접 추가)

아래와 같이 VCC 창의 내용이 바뀌었을 것입니다. Modular Avatar와 NDMF를 VCC에 등록하기 위해 Add 버튼을 누릅니다.

Add를 누른 후, 다시 사용하려는 프로젝트의 Manage Project 창으로 돌아옵니다. 표시되는 기능 리스트에서 Non-Destructive Modular Framework 와 Modular Avatar를 찾아서 프로젝트에 설치합니다.

Modular Avatar를 먼저 설치하면 NDMF가 동시에 설치됩니다.

이로써 아바타 프로젝트의 사전 준비가 완료되었습니다. 이제 아바타 프로젝트를 Unity로 엽니다.

만약 프로젝트를 새로 만든 경우, 사용하려는 아바타와 쉐이더 등, 진행하기 전에 필요한 준비물을 사전에 준비해둡니다.

마땅히 사용할 아바타가 없거나, 매우 가벼운 아바타를 찾고 계시다면, 이 튜토리얼을 위해 간단히 변환해본 'k' 아바타를 사용해보세요. CC0 라이선스이며, 매우 가볍습니다. 만약 투명 아바타가 필요하다면, 이 아바타에서 Body 오브젝트를 지우기만 하면 끝입니다!

https://harunadev.booth.pm/items/6301908 또는 바로 다운로드

2. 아바타에 카메라 기믹 준비

이제 아바타에 카메라 기믹을 설치할 것입니다. 만약 설치할 줄 알거나, 이미 설치되어 있다면 다음 스탭으로 넘어가도 좋습니다.

사용하고자 하는 카메라 기믹을 다운로드하고 프로젝트에 불러온 후, 아바타에 설치합니다.

경고

'카메라 기믹의 설치' 과정은 스킵되어 있습니다. 카메라 기믹마다 다른 설치방법을 요구하며, 대부분 서로 작동방식이 다르기에 이 부분에서 다루지 않습니다. 설치 방법은 각 카메라 기믹의 설명서 또는 튜토리얼 등을 참고하여 직접 설치하시기 바랍니다.

이후부터는 '카메라 기믹을 패치'하는 과정을 다룹니다.

이제 아바타에 카메라 기믹을 패치할 차례입니다. UniversalPatcher를 임포트합니다. 그 후에 아바타 오브젝트를 우클릭하고, 메뉴창에서 PrismStudio Auto Setup -> Auto Detect (자동 감지) 옵션을 선택합니다. (또는 PrismStudio Auto Setup 옵션 하위에 본인이 사용중인 카메라 기믹을 수동으로 선택합니다.)
아바타를 우클릭하고 PrismStudio Auto Setup - Auto Detect 옵션을 선택하는 사진

정보

자동 감지에 실패하면 Console창에 감지 실패 경고 메세지가 표시됩니다. 이 경우에는 대부분 PrismStudio가 지원하지 않는 카메라이거나 아바타에 카메라 기믹 설치가 잘못되었을 가능성이 높습니다.

자동감지에 성공하면 UniversalPatcher 오브젝트가 생성됩니다. 오브젝트를 클릭해서 속성을 확인합니다. 아바타와 카메라가 정상적으로 삽입되었는지 확인합니다.

이렇게만 해두면 준비 끝입니다 (진짜로). 이제 아바타를 업로드합니다.

PrismStudio를 써보자!

아바타가 준비되었다면, 이제 PrismStudio를 직접 써볼 시간입니다. 이 스텝을 익혀두시면, PrismStudio를 그 누구보다 빠르고 남다르게 준비하실 수 있을것입니다.

1. VRChat에서 아바타를 준비

1-1. 아바타 최초 업로드/업데이트

처음 아바타를 업로드하거나 아바타를 재업로드했다면, 아래 스탭을 통해 아바타를 초기화합니다.

  1. Options / OSC 에서, OSC가 켜져 있는지 확인하시고, Reset Config을 눌러서 리셋합니다.
2. `Expressions / Quick Actions` 에서 `Reset Avatar`를 통해 아바타를 리셋합니다.

1-2. 아바타에서 패치 활성화

Expressions / PrismStudio / Toggle PrismStudio를 켜서 프리즘스튜디오를 활성화합니다.

1-3. World 드랍 모드?

프리즘스튜디오의 루트 위치와 각도 (XYZ 0, 0, 0) 를 정의하는 모드가 있습니다.

  • Do not fix position
    • 프리즘스튜디오의 루트 위치와 각도를 아바타 Root에 고정하며, 아바타를 따라다닙니다.
  • Fix Position to Current
    • 프리즘스튜디오의 루트 위치와 각도를 현재 아바타가 서있는 위치에 고정합니다.
  • Fix Position to World Origin
    • 프리즘스튜디오의 루트 위치와 각도를 월드의 루트 위치와 각도와 동일하게 고정합니다.

위 기능을 활용하면, VR 환경에서와 같이 본인이 움직이는 환경에서 프리즘스튜디오를 안정적으로 사용할 수 있게끔 도와줍니다.

2. PrismStudio Unity 프로젝트

VRChat과 아바타는 준비되었습니다. 이제 PrismStudio Unity 프로젝트를 열어볼 것입니다.

Unity Hub을 실행하고, Open 버튼을 눌러 Unity Hub에 PrismStudio Unity 프로젝트를 추가합니다.

폴더 선택창에서 PrismStudio 폴더를 선택하고 Add Project 버튼을 누릅니다.

Unity Hub에 PrismStudio가 추가되었습니다. 항목을 클릭해서 엽니다. 다음에 프리즘스튜디오를 사용할때도 이 항목을 클릭하면 바로 열 수 있습니다.

PrismStudio Unity 프로젝트는, 쉬운 시작을 위한 Scene이 포함되어 있습니다. Scene 파일을 열면 PrismStudio를 사용하기 위한 모든 준비가 된 환경을 열 수 있습니다.

사용을 시작하기 전에, 항상 PrismStudio 오브젝트 구조를 확인합니다 (PrismStudio 오브젝트가 파란색 프리팹으로 되어있는지).