NanaCast Exporter 사용법

NanaCast Exporter는 Unity에서 아바타·무대·소품·모션을 NanaCast 뷰어용 파일로 내보내는 패키지입니다. VRChat SDK를 호출하지 않으며, 내보낸 파일에는 VRChat SDK의 자산이 들어가지 않습니다.

•Unity 2022.3 (2022.3.22f1 권장)

•Built-in 렌더 파이프라인 프로젝트 (URP·HDRP는 지원하지 않습니다)

•아바타를 내보내려면: VRChat SDK가 설치된 아바타 프로젝트 (Modular Avatar / NDMF / VRCFury가 있으면 업로드할 때와 같은 빌드를 거친 뒤 내보냅니다)

•무대·소품·모션만 내보내려면: 일반 Unity 프로젝트로도 충분합니다

VCC(VRChat Creator Companion) 또는 ALCOM에서:

1)설정 → 패키지(Packages) → 저장소 추가(Add Repository)

2)주소 입력: https://nanacast.app/vpm/index.json

3)프로젝트 관리(Manage Project)에서 "NanaCast Exporter"를 추가합니다. (NanaCast Runtime은 자동으로 같이 설치됩니다)

새 버전이 나오면 VCC에서 업데이트를 누르면 됩니다.

설치가 끝나면 Unity 메뉴에 다음 두 항목이 생깁니다.

•Tools → NanaCast → Avatar Exporter (아바타는 VRChat SDK가 있는 아바타 프로젝트에서 내보냅니다)

•Tools → NanaCast → Content Exporter (무대·소품·모션)

두 창 모두 오른쪽 위에서 표시 언어를 고를 수 있습니다 (한국어 / 日本語 / English / 简体中文 / 繁體中文).

1)아바타가 있는 씬을 엽니다.

2)Tools → NanaCast → Avatar Exporter 를 엽니다.

3)"아바타" 칸에 씬의 아바타(VRC Avatar Descriptor가 있는 루트 오브젝트)를 넣습니다. 씬에서 아바타를 고른 상태로 창을 열면 자동으로 들어갑니다.

4)"익스포트"를 누릅니다. 아바타에 따라 1~3분 걸립니다.

5)끝나면 .ncavatar 파일이 있는 폴더가 열립니다. 기본 위치: 문서\NanaCast\Avatars

6)뷰어의 "아바타" 페이지 → "내 아바타" 목록에서 고르면 불러옵니다.

•원본 아바타와 프로젝트 에셋은 수정하지 않습니다(복제본으로 작업합니다).

•PhysBone, 컨스트레인트, 컨택트, Expressions 메뉴와 파라미터, 애니메이터가 함께 들어갑니다.

•VRChat 기본 애니메이션(서기, 손 제스처 등)은 NanaCast의 자체 애니메이션으로 바뀌어 들어갑니다.

•창 아래에 경고가 나오면 그 내용을 확인해 주세요. "VRChat SDK 자산 포함: 0개"가 나오면 정상입니다.

주의: 내보낸 .ncavatar 파일에는 아바타 모델 원본이 들어 있습니다. 다른 사람에게 주지 마세요. 아바타·의상을 VRChat 밖에서 써도 되는지는 각 제작자의 이용 약관을 확인하세요.

1)무대로 쓸 씬을 엽니다. 라이트맵을 쓴다면 먼저 구워 둡니다.

2)아바타가 설 자리에 빈 오브젝트를 만들고 NcStage 컴포넌트를 붙입니다. 그 오브젝트의 위치와 Y축 회전(바라보는 방향)이 아바타 자리가 됩니다. 없으면 원점(0,0,0)에 섭니다.

3)씬을 저장합니다.

4)Tools → NanaCast → Content Exporter → "무대" 탭 → 씬을 넣고 "무대 내보내기".

5)기본 저장 위치: 문서\NanaCast\Stages

6)뷰어의 "연출 → 배경" 탭에서 종류를 "무대"로 고르면 목록에 나옵니다.

•라이트맵, 스카이박스, 조명, 반사 프로브, 파티클, 애니메이션이 함께 들어갑니다.

•직접 작성한 스크립트(C#)는 뷰어에서 동작하지 않습니다. 모양만 보입니다.

•씬의 후처리(Post Processing Stack 등)는 넘어가지 않습니다. 뷰어의 "연출 → 후처리"를 쓰세요.

1)소품으로 쓸 프리팹(또는 씬 오브젝트)을 준비합니다.

2)아바타 몸에 붙일 소품이면 루트에 NcProp 컴포넌트를 붙이고, 붙일 뼈(손, 머리 등)와 위치·회전·크기를 정합니다. 붙일 뼈를 "LastBone"(없음)으로 두면 월드에 고정된 소품이 됩니다.

3)Content Exporter → "소품" 탭 → 프리팹을 넣고 "소품 내보내기".

4)기본 저장 위치: 문서\NanaCast\Props / 뷰어의 "소품·모션" 페이지에서 켜고 끕니다.

•PNG·JPG 이미지를 Props 폴더에 그대로 넣어도 판 모양 소품으로 쓸 수 있습니다.

1)휴머노이드 애니메이션 클립을 준비합니다.

2)Content Exporter → "모션" 탭 → 클립을 넣고, "반복 재생"과 "재생 중 몸 트래킹 대신"을 정한 뒤 "모션 내보내기".

3)기본 저장 위치: 문서\NanaCast\Motions / 뷰어의 "소품·모션" 페이지에서 재생합니다.

문서 폴더 대신 다른 폴더를 쓰려면 %APPDATA%\NanaCast\content-root.txt 파일에 폴더 경로 한 줄을 적습니다. (예: D:\NanaCast) 뷰어와 익스포터가 같은 폴더를 씁니다.

•내보내기 창 아래의 로그·경고와 Unity 콘솔의 오류를 확인해 주세요.

•해결되지 않으면 화면 캡처와 함께 X(트위터) @Gyunana_VRC 로 알려 주세요.

NanaCast는 비공식 프로그램이며 VRChat Inc.와 관계가 없습니다. 이용약관: https://nanacast.app/terms / 개인정보처리방침: https://nanacast.app/privacy