--- title: Installation and settings slug: world-sdk-guide/installation-and-settings docTags: createdAt: 2024-09-02T08:34:13.136Z --- ## STEP 1 : Installing Unity and Registering ZEPETO Template ZEPETO Worlds can be created using the Unity Tool. The following is a list of packages required for creating a ZEPETO World. 1\) Download Unity Hub and Unity 2022.3.34f1 version. ([Download](https://unity3d.com/get-unity/download/archive)) :::hint{type="danger"} ❗️**Caution** - ZEPETO World can only be developed in Unity 2022.3.34f1 version - If you have been using a different version of Unity, please follow the [the guide below to upgrade to version 2022.3.34f1](docId\:UEztlu2Os-3Wz-uFkdIGV) ::: 2\) Required Modules per Operating System - When installing Unity, ensure you include the following modules based on your operating system: - Android Build Support - iOS Build Support - Mac Build Support (Mono) - Install if your PC is running Windows - Windows Build Support (Mono) - Install if your PC is running Mac ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-8CJ0uzNuspmA5yoyQ1QeL-20240904-102417.png) ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-F5R98ztbnbpF-5108VKe6-20240904-102417.png) 3\) Download the ZEPETO World Template from the following link :::hint{type="info"} **πŸ“˜ ZEPETO World Template Installer Download** [https://upm.zepeto.run/setup/package](https://studio.zepeto.me/console/download/652892d3a80a9f5505ed8890) ::: 4\) Create a new project on Unity Hub. ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-8oJWg0Agjk50LLR2rKECd-20240904-102417.png) 5\) After a new project is created, go to Unity Menu β†’ Assets β†’ Import Package β†’ Custom Package, then add the downloaded ZEPETO World Template Installer(ZEPETO.World.unitypackage file). ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-XyI2Qxq48veVxYNJ5hzel-20240904-102417.png) 6\) Once the ZEPETO World Template Installer has completed the auto configuration, restart the Unity Editor and Unity Hub to complete the template registration. ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-ioq0_KU77809ans0rq2Vy-20240904-102417.png) :::hint{type="danger"} ❗️**Caution** - Errors may occur during template installation if there are Korean or full-width characters in the installation path. - Please proceed after changing the folder name to English. - The operating system account name must also be in English to prevent errors. ::: ## STEP 2 : Getting Started with Templates Templates make it easy to test the World development process. Go to the Template menu by clicking on the \[New] button at the upper right of Unity Hub. ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-TbSM8-IBrPyH5nkVHcJHB-20240904-102417.png) Select \[ZEPETO Default Project], and enter the project name and save location. ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-6w0wbRMqXNp90wAWcUqc0-20240904-102417.png) Once the project is created, open SampleScene. ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-aYotjktD6i5uvDkZI_mLu-20240904-102417.png) Click on the \[β–ΆοΈŽ(play)] button on the top center of Unity Editor to view default example actions. Verify that the cube at the center of the screen is rotating properly. ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-Ax5OduqqMGNXcKT1reXB9-20240904-102417.png) ## STEP 3 : Registering a World in ZEPETO Studio To create a World, basic information such as the World ID must be registered on the World console. :::hint{type="info"} **πŸ“˜ **Please refer to the following guide. \[[Making a World Console](docId\:PJSq92GFq_V-Xe2vxBZQK)] ::: Check the World ID on the studio console screen.(ex: com.default.jumpworld) ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-WMBGm93NIFsw7qEbTiI9J-20240904-102417.png) ## STEP 4 : Logging in to Unity Editor You must log in to ZEPETO to use the various tools for creating a World. On the menu in the middle of the screen, click the \[β–Ό] button to open a second menu. Click the \[Login] button in the submenu. ::Image[]{src="https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-a4ISpROxfSvLUIIi22cGV-20240904-102417.png" size="76" width="1084" height="706" position="center" showCaption="false"} Selecting \[Login] takes you to `Project Setting > ZEPETO Service` feature, where you can log in to ZEPETO Service. There are three ways to log in: - Email: Log in using your ZEPETO account email or ZEPETO ID. - Phone: Log in using your ZEPETO account phone number. - QR: Open the ZEPETO app and use the scan QR feature to log in. ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-oILF9veqAyCSvBZzHZeqj-20240904-102417.png) ## STEP 5: Linking World Information in ZEPETO Service Once you have successfully logged in, you can view a list of world names created in ZEPETO Studio in the ZEPETO Service window. Select the world name and click the Link to Selected World button. ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-ojp67inhYvuZowbAgn6a_-20240904-102417.png) ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-73iZbXYEjPcD-zB0pMgk4-20240904-102417.png) :::hint{type="success"} πŸ‘ **Tip** - To log out, click `Unlink World > Logout`. - Once you sign in, the login authentication is valid for one month. After one month, your login authentication will expire, and you may be automatically signed out. - If you logged into the Unity Editor in versions of World before 1.21.14, Make sure to update to World 1.21.14 or newer, then log in again in Project Settings > ZEPETO Service. ::: ## STEP 6: Setting Up the World Click the \[β–Ό] button in the middle of the Unity project menu. On the pop-up menu, click the \[Open World Settings]. ![World Settings](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-9WY80CuCzCU8X7PhPo9-1-20240904-102417.png) Click the \[Open World Settings] as shown in the image below to set the World Setting. | Property | Summary | | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Version | Enter the version of your file to be registered. | | MaxClients | Set the maximum number of people who can access the room. | | Orientation | Choose the orientation of the screen.

- Vertical

- Horizontal | | Room Options | - Disable Invite : Disables room invitation function.

- Disable Room List : Disables the ability to check the room list.

- Disable Private Room : Disables the ability to create a private room. | :::hint{type="success"} **πŸ‘ Invitation via test link** Even if the room invitation function is off, you can send invites through the test link. ::: :::hint{type="danger"} ❗️**Caution** - World Settings values ​​are reflected in the build. - If you want to change World Settings such as vertical/horizontal screen mode, maximum number of clients, etc., please change the values ​​and re-publish. Then, please register a new Package file in ZEPETO Studio. ::: In the Unity project, select Menu β†’ Edit β†’ Project Settings to open the \[Project Settings] window. On the \[Player] tab on the left, enter the Company Name and Product Name as follows: - Company Name: default - Product Name: jumpworld(name of the World) ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-_35-XqPOEta_jk3l8nI3n-20240904-102417.png) ## STEP 7 : Registering Scenes In the Unity project, open the Settings window by going to Menu β†’ File β†’ Build Settings. Register all scenes needed for the actions in your World in \[Scenes in Build]. Scenes must be in chronological order(start screen first) ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-jjlHjZdnOoKj4nyjficrb-20240904-102418.png) :::hint{type="danger"} **❗️ Caution** If you do not register the scene, it may not appear correctly when QR tested or published. :::