ZEPETO CharacterController allows avatar loading, character movement and camera control functions.

## STEP 1 : Generate

In the Hierarchy window, select ZEPETO → ZepetoPlayers tab.

<br>

An object called ZepetoPlayers will be automatically created as shown below. ZepetoPlayers is a component that manages character controller modules within the World.

Set values for character control and related functions can be set in the Inspector window.

<br>

## STEP 2 : To Load Character

Once the CharacterController setting is complete, use the provided script to load a character.

Add a GameObject in the Scene and add the ZEPETOScript as shown below.

<br>

You can load ZEPETO characters with controllers directly to the Scene.

Enter the ZEPETO ID in [ZEPETO_ID] to load the character.

❗️

Caution

When releasing the world, you should modify the code based on the ZEPETO ID of the user who accessed the world, instead of the ZEPETO ID entered in the code.

📘



Please refer to the following guide. [\[Create a ZEPETO Character\]](🔗)

<br>

## STEP 3 : To Run CharacterController

Use the [▶︎(play)] button at the center of the screen to check that the CharacterController is working properly.

CharacterController has a common character control Key Mapping for each Input Event corresponding to the device (PC/Mobile). Thus, the loaded character can be controlled in a Scene regardless of the platform.

On a PC, characters and cameras can be operated with a mouse. On a mobile device, characters and cameras can be operated with a virtual pad as shown in the screenshots below.

<br>

<br>

👍

The following input interfaces are supported for character control:

**PC**

• Move: Keyboard arrows, WASD

• Jump: Space

• Double Jump : (Left) Shift

• Zoom: Mouse wheel

• Rotate: Screen drag

**Mobile**

• Move: (Bottom left screen)virtual pad

• Jump: (Bottom right screen)virtual pad button

• Zoom: (Two fingers)screen drag

• Rotate: (One finger)screen drag

<br>

## STEP 4 : To Set Up

You can change the settings of the Character Controller with Default Setting.

Click the ZepetoPlayers object created in the Hierarchy window, then you can view the settings of the currently applied Controller by Parameter in the Inspector window.

<br>

When creating LocalPlayer, ZepetoCamera normally focuses on the upper part of local character's head, and moving the camera / character will cause it to continue following.

Details of each item are as follows.

## STEP 4-1 : Camera (Previous Version)

To change the relative position of Target and Camera, try changing the following properties:

• Distance : Zoom, maxZoomDistance, minZoomDistance

• Rotation : Sensitivity, Speed

<br>

## STEP 4-2 : Camera (Enhanced Version)

Starting with ZEPETO.World-1.6.0 version , further enhanced camera modules are available. (available after ZEPETO Apps 3.15.0)

Pressing the 'Replace with Enhanced Camera' button on the top will replace the new camera module. The new camera module is highly compatible with all functions of the existing camera module.

❗️

Caution

New camera module via Inspector → Reverse replacement of existing camera module is not supported.

<br>

## STEP 4-3 : Player

• MotionController : Select Motion Controller Version (V1, V2)

  • Improved Character MotionV2 with ZEPETO.World-1.1.6. (Compatible with Zepeto App 3.11.2 or later)

  • Core Motions are backwards compatible between V1 and V2.

<br>

<br>