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.
- Download Unity Hub and Unity 2020.3.9f1 version. (Download)
- Download the ZEPETO World Template from the following link
ZEPETO World Template Installer Download
Caution
ZEPETO World can only be developed in Unity 2020.3.9f1 version
Create a new project on Unity Hub.
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).
Once the ZEPETO World Template Installer has completed the auto configuration, restart the Unity Editor and Unity Hub to complete the template registration.
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.

Select [ZEPETO Default Project], and enter the project name and save location.
Once the project is created, open SampleScene.
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.
STEP 3 : Linking a World ID to a project
To create a World, basic information such as the World ID must be registered on the World console.
Please refer to the following guide. [Making a World Console]
Check the World ID on the studio console screen.(ex: com.default.jumpworld)

Click the [▼] button in the middle of the Unity project menu.
On the pop-up menu, click the [Open World Settings].

In the World ID box, enter the ID registered in the World console.

Click the [Open World Settings] as shown in the image below to set the World Setting.
Property | Summary |
---|---|
World Id | Enter your World ID. |
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. |
Invitation via test link
Even if the room invitation function is off, you can send invites through the test link.
STEP 4 : Setting up the project in Unity
Check the World ID on the studio console screen.(ex: com.default.jumpworld)
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)
STEP 5 : Logging In
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.

Select [login] menu at pop up window and enter your ZEPETO ID and password.

STEP 6 : 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)
Caution
If you do not register the scene, it may not appear correctly when QR tested or published.