Unity 플러그인
Unity로 내보내기 — 전체 워크플로
1. PicoBerry Unity 플러그인 다운로드
먼저 공식 플러그인을 설치합니다.
- PicoBerry 웹사이트로 이동합니다
- Unity Plugin 섹션을 엽니다: 3D 뷰어 하단에서 찾거나 https://unity.umodeler.com/download 에서 확인할 수 있습니다


- 최신 Unity 패키지(.unitypackage)를 다운로드합니다
- 찾기 쉬운 곳에 저장합니다
이 플러그인은 가져오기, 머티리얼, 텍스처, 모델 설정을 자동으로 처리합니다.
2. 플러그인을 Unity로 가져오기
Unity 프로젝트 안에서:
- Unity를 엽니다
- Assets → Import Package → Custom Package로 이동합니다
- 다운로드한 PicoBerry Unity 플러그인을 선택합니다
- Import를 클릭해 필요한 스크립트와 폴더를 모두 가져옵니다
3. PicoBerry 계정에 로그인 (Unity 안에서)
플러그인 설치 후:
Unity 플러그인을 가져온 뒤 Unity 안에서 PicoBerry 창을 엽니다. 이전에 이미 PicoBerry에 로그인한 적이 있다면, 플러그인이 자동으로 계정에 연결되어 모델을 표시합니다. 그렇지 않으면 Unity가 로그인을 요청합니다.
이렇게 하면 Unity 프로젝트가 PicoBerry 라이브러리에 직접 연결됩니다.
4. 가져올 에셋 선택
PicoBerry Unity 창 안에서:
- Collections, Models, Recent Generations를 둘러봅니다
- Unity로 가져올 에셋을 클릭합니다
- 가져오기 전에 미리 봅니다 (메시, 텍스처, 머티리얼)
이렇게 하면 올바른 버전을 가져올 수 있습니다.
5. 모델을 프로젝트로 가져오기
준비되면:
- Import to Unity를 클릭합니다
- 플러그인이 자동으로:
- 메시를 다운로드합니다
- 텍스처를 적용합니다
- 머티리얼을 설정합니다
- 프리팹을 만듭니다
- 모든 것을 깔끔한 폴더 구조에 배치합니다
수동 설정이 필요 없습니다.
6. 프리팹을 씬에 드래그
가져온 에셋은 Project 창에 프리팹으로 나타납니다.
씬에 드래그하기만 하면 사용할 수 있습니다.
이제 다음을 할 수 있습니다.
- 크기 조정
- 애니메이션 적용
- 콜라이더 추가
- 스크립트 추가
- 게임플레이에 사용
이제 PicoBerry 에셋이 Unity 프로젝트의 완전한 일부가 되었습니다.
Asset Library 윈도우
Unity 에디터 안에서 PicoBerry 에셋을 한 곳에서 관리하는 윈도우입니다. 자세한 사용법은 에셋 라이브러리 페이지를 참조하세요.
- 메뉴
Tools → PicoBerry → Asset Library로 엽니다. Image/3D필터로 에셋을 분류합니다.- 다중 선택 후 Add to Scene 또는 Add to Collection 으로 일괄 처리합니다.
- 우측 상단 워크스페이스 스위처로 Personal / Team 사이를 전환합니다.
PicoBerry 컴포넌트로 씬에서 직접 생성
Tools → PicoBerry → PicoBerry 오브젝트 생성 (또는 동일 기능의 상단 버튼)으로 씬에 PicoberrySceneGenerator 컴포넌트가 부착된 오브젝트를 만들 수 있습니다. Inspector 가 생성 단계에 따라 UI 를 자동으로 전환합니다.
- 로그인 전 — Inspector 상단에 SignIn UI 가 표시됩니다.
- 생성 중 — 진행률·프로그래스바가 표시됩니다.
- 완료 후 — Apply 버튼으로 결과를 씬에 반영합니다.
크레딧이 부족한 상태에서 생성을 시도하면 인라인 에러 대신 전용 다이얼로그가 표시되어, 결제 페이지로 바로 이동할 수 있습니다.
본 · 애니메이션 자동 임포트
glTF 에셋이 본 / 애니메이션 클립을 포함하는 경우, 임포트 시 본 계층과 AnimationClip 이 자동으로 구성됩니다. 자세한 내용은 본 · 애니메이션 임포트 페이지를 참조하세요.
