월드 개발 시작하기

1단계 unity 설치 및 zepeto 템플릿 등록 zepeto 월드는 unity 툴을 통해 개발할 수 있습니다 다음은 zepeto 월드 개발을 위한 필수 패키지 목록입니다 1\) unity 허브와 unity 2022 3 34f1 버전을 설치합니다 ( 다운로드 https //unity3d com/get unity/download/archive ) ❗️ 주의 zepeto 월드는 unity 2022 3 34f1 버전에서만 개발할 수 있습니다 다른 버전의 유니티를 사용하고 있었다면, 다음을 따라주세요 unity 2022로 업그레이드하는 방법 docid 51av2o9bcbiwbtcxminct 2\) 운영 체제별 필수 모듈 unity를 설치할 때, 운영 체제에 따라 다음 모듈을 포함해야 합니다 안드로이드 빌드 지원 ios 빌드 지원 mac 빌드 지원 (mono) windows를 사용 중인 경우 설치 windows 빌드 지원 (mono) mac을 사용 중인 경우 설치 3\) zepeto 월드 템플릿을 다음의 링크에서 다운로드합니다 📘 zepeto 월드 템플릿 설치 프로그램 다운로드 https //upm zepeto run/setup/package https //studio zepeto me/console/download/652892d3a80a9f5505ed8890 4\) unity hub에서 새 프로젝트를 생성하세요 5\) 신규 프로젝트가 생성되면 unity 메뉴에서 assets → import package → custom package 를 차례로 클릭하여, 다운로드 받은 zepeto world template installer(zepeto world unitypackage 파일)을 추가합니다 6\) zepeto world template installer가 자동 환경 설정을 완료하면, unity 에디터와 unity 허브를 재실행하여 템플릿 등록을 완료합니다 ❗️ 주의 설치 경로에 한글이나 전각 문자가 있을 경우 템플릿 설치 단계에서 오류가 발생할 수 있습니다 폴더 이름을 영문으로 변경한 후 진행하여 주세요 운영체제 계정명도 영어로 되어 있어야 오류가 발생하지 않습니다 2단계 템플릿 시작하기 템플릿을 통해 월드 제작 과정을 간단하게 테스트할 수 있습니다 unity 허브에서 오른쪽 상단의 \[new] 버튼을 클릭하면, 템플릿 메뉴가 나타납니다 템플릿 메뉴 중 \[zepeto default project]를 선택하고, 프로젝트의 이름과 저장할 위치를 입력합니다 프로젝트가 생성되면 samplescene을 엽니다 unity 에디터 상단 중앙의 \[▶︎(play)] 버튼을 클릭하면 기본 예제 동작을 확인할 수 있습니다 화면 중앙의 큐브가 정상적으로 회전되는지 확인합니다 3단계 zepeto studio에서 월드 등록하기 월드 개발을 시작하기 위해서는, 개발하려는 월드의 id를 포함한 기본 정보를 월드 콘솔에서 등록해야 합니다 월드 콘솔을 만들기 위한 자세한 방법은 월드 콘솔 만들기 가이드에서 확인할 수 있습니다 📘 다음 가이드를 참고하여 주세요 \[ 월드 콘솔 만들기 docid 7hdt0opmetyqajjxsa0ei ] 스튜디오 콘솔 화면에서 월드 id를 확인합니다 (ex com default jumpworld) 4단계 유니티 에디터에 로그인하기 월드 개발의 많은 기능들이 zepeto 로그인 기반으로 동작합니다 개발 툴에서 zepeto에 로그인하려면, 화면 중앙 메뉴에서 \[▼] 버튼을 클릭하여 보조 메뉴를 오픈합니다 보조 메뉴에서 \[login] 버튼을 클릭합니다 \[로그인]을 선택하면 프로젝트 설정 > zepeto 서비스 기능으로 이동하여 zepeto 서비스에 로그인할 수 있습니다 3가지 방법으로 로그인이 가능합니다 email 제페토 계정 email 또는 제페토 아이디를 입력해서 로그인 phone 제페토 계정 전화번호를 입력해서 로그인 qr 제페토 앱을 열고, scan qr기능을 사용해서 로그인 5단계 zepeto service에서 월드 정보 연결하기 로그인에 성공하였다면 zepeto service 창에서 제페토 스튜디오에서 생성한 월드 이름 목록을 확인할 수 있습니다 월드 이름을 선택하고 link to selected world 버튼을 클릭해 주세요 👍 팁 로그아웃을 하고 싶다면 unlink world > logout을 눌러 주세요 한 번 로그인하면 로그인 인증이 한 달 동안 유지됩니다 한 달 이후에는 로그인 인증이 만료되어 자동 로그아웃이 될 수 있습니다 월드 1 21 14 미만 버전에서 유니티 에디터를 로그인 하셨던 경우, 월드 1 21 14 이상 버전으로 업데이트를 하신 후에 project settings > zepeto service에서 반드시 로그인을 새로 진행하여 주세요 6단계 월드 세팅하기 개발 중인 unity 프로젝트 화면 중앙 메뉴에서 \[▼] 버튼을 클릭합니다 클릭 후 나타나는 팝업 메뉴에서 \[open world settings] 버튼을 클릭합니다 세계 설정 world settings 각 항목의 상세 내용은 다음과 같습니다 속성 요약 version 스튜디오 콘솔에 등록할 파일의 버전을 입력합니다 maxclients 방에 접속할 최대 인원수를 설정합니다 orientation 화면의 방향을 선택하세요 vertical 세로 horizontal 가로 room options 멀티플레이 월드에서 사용 가능한 룸 설정입니다 disable invite 방 초대 기능 사용할 수 없도록 설정합니다 disable room list 생성된 방 리스트를 확인할 수 없도록 설 정합니다 disable private room 비공개 방을 만드는 기능을 사용할 수 없도록 설정합니다 👍 테스트 링크를 통한 초대 방 초대 기능이 꺼져 있어도 테스트 링크를 통해 초대를 보낼 수 있습니다 ❗️ 주의 world settings 값들은 빌드에 반영됩니다 화면의 가로 모드/세로 모드, 최대 입장 수 등 world settings 값을 변경하고 싶다면, 값을 변경한 후 새로 publish를 진행해 주세요 그 후, zepeto studio에 새로운 package 파일을 등록해 주세요 개발 중인 unity 프로젝트에서 menu → edit → project settings를 선택하여, \[project settings] 창을 오픈합니다 왼쪽의 \[player] 탭에서 company name과 product name을 다음 예시와 같이 구분하여 입력합니다 company name default product name jumpworld(월드 이름) 단계 7 scene 등록하기 unity 프로젝트에서 menu → file → build settings 메뉴를 선택하여 설정 창을 오픈합니다 \[scenes in build] 항목에 월드 내 동작에 필요한 모든 scene를 등록합니다 월드 시작 시 가장 먼저 실행되어야 하는 화면을 목록의 가장 위쪽에 등록해야 합니다 ❗️ 주의 scene을 등록하지 않으면 qr 테스트 또는 퍼블리싱 했을 때 올바르게 보이지 않을 수 있습니다