Skip to main content

Avatar System

Webaverse supports many avatars in the game. By default the player has one avatar.

Activating Avatars

We can add many more avatars into a scene. Those avatars can be activated if the player gets near the avatar and then activates the swap command with the E button.

Avatar Setup

Avatars can be set up as objects in a .scn (Scene) file.

"position": [
"quaternion": [
"start_url": "",
"dynamic": true


  • Position

    • Object's position in 3D world. (0,0,0) is the center of the world
  • Quaternion

  • Start_url

    • Location where the avatar object is located. We have many options to choose from to provide information about an object's definition. Look for the Object loading system for more information. In this particular example we are loading a 3D model from a remote location via url
  • Dynamic

    • Should we load object dynamically?

Object loading system

We can load many object types into our 3D world. Supported object types are:

  • .glb
  • .vox
  • .vrm
  • and our own custom types for scene configuration

We can load an object from a local directory (for example "start_url": "/public/avatars/scillia.vrm") or from a remote location (for example "start_url": "").

Webaverse provides solutions for complex object loading with JavaScript file loading. The folder structure looks like this:


.totum is the entry point for loading.

"start_url": "index.js",
"components": []


  • start_url – it can be 3D model file .glb .vox .vrm or JavaScript file. If we provide JavaScript file, we can import complex Three.js objects with many custom properties and with update function as well.

  • components – custom components passed directly to Webaverse app object