[zepeto] 제페토 개발 환경 구성하기

unity기반 zepeto 개발 환경 구성하기

Unity 설치

---

제페토 월드 제작 및 등록, 관리 등을 위해 Unity를 설치한다.

vs 제페토 빌드잇

제페토 맵을 제작할 수 있는 툴이다. 배포 후, 월드나 아이템 등의 관리 기능 등은 제공하지 않는 것으로 보인다.

제페토 설정 가이드에 보면 기본적으로 설치해야할 목록을 확인할 수 있다.

제페토 개발을 위한 기본 설치 목록

Unity 2020.3.9f1 버전 설치

Archive 에서 2020.3.9.f1 버전을 찾아 설치한다.

각 운영체제(mac, windows 등) 에 해당하는 Unity Installer 설치 unity 2020.3.9f1 버전

Unity Installer를 통해 Unity component 설치 Unity Download Assistant

Unity 2020.3.9f1 컴포넌트 설치

Unity hub 설치

Unity를 버전별로 관리하고, 각 프로젝트 관리 등을 위한 도구이다.

Unity 실행시 Unity hub가 설치되어 있지 않다면 필수로 설치를 요구한다.

각 OS에 맞는 Unity Hub를 설치한다. 최신 버전을 받아도 상관없다.

Unity Hub 설치

제페토 패키지 추가

---

제페토 월드를 개발하기 위한 기본 템플릿을 Unity 에 추가한다.

먼저, 패키지를 다운로드한다.

패키지 추가 방법

1. 임의의 프로젝트 생성 임의의 프로젝트 생성
2. 제페토 패키지 추가 제페토 패키지 추가 제페토 패키지 추가
3. Unity Hub 내 제페토 프로젝트 기반의 새로운 프로젝트 생성 제페토 패키지 기반 프로젝트 생성

제페토 프로젝트 기본 화면

---

기본적인 제페토 프로젝트의 화면은 아래와 같다. 제페토 패키지 기반 프로젝트 기본 화면

제페토 플레이어 추가 예제

---

제페토 플레이어 추가하는 예제 를 실습해보자.

실습 예제대로 players 컴포넌트 추가후 실행해보면, 캐릭터가 한없이 추락할 것이다.

plane 컴포넌트를 추가해 캐릭터가 활동할 수 있는 공간을 만들어주자

• plane component 추가 plane component 추가

• 더이상 떨어지지 않고, plane 위에서 이동할 수 있는 player plane component 위에서 움직이는 player

에러

---

처음 설치 때, mac 에서 특정 라이브러리가 없어서 제페토 프로젝트가 생성이 되지 않는 이슈가 있었다.

제페토 패키지 프로젝트 실행 에러

위의 과정대로 설치를 진행했음에도 불구하고, 제페토 기본 프로젝트 생성이 안될 수 있다.

특정 라이브러리 혹은 파일이 없다는 에러였지만, windows 환경에서 위의 과정대로 정상 실행되는 것을 확인했다.

mac 버전만의 에러인가 싶었으나 재설치후 오류가 해결되었다.

아래와 같이 사용자 데이터를 모두 삭제 후 재설치를 진행한다.

Unity 삭제 및 재설치를 통한 에러 해결

% rm -rf /Applications/Unity
 
% rm -rf /Applications/Unity Hub.app
 
% rm -rf /Library/Application Support/Unity
% rm -rf ~/Library/Unity
 
% rm -rf ~/Library/UnityHub