Studio GuideWorld SDK Guide
Log In

Installation and settings

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



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.



  • 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.

World IdEnter your World ID.
VersionEnter the version of your file to be registered.
MaxClientsSet the maximum number of people who can access the room.
OrientationChoose 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)




If you do not register the scene, it may not appear correctly when QR tested or published.