Avatar

Context: object.virtual.avatar

This document describes the data structure for a virtual avatar, a digital representation of a character or persona used in virtual environments, games, or other digital applications. Virtual avatars can be created using various methods, such as 3D modeling, procedural generation, or even AI-driven techniques.

Fields

Key	Type	Description	Mandatory
class	string	Class or category the avatar belongs to	Yes
generation	string	Generation or version of the avatar	Yes
rootBone	string	Root bone in the avatar's skeletal hierarchy	Yes
modifiers	modifierObject	Modifiers applied to customize the avatar	No

Modifier Object

Key	Type	Description	Mandatory
name	string	Name of the modifier	Yes
type	string	Type of the modifier (e.g., shape, color, size)	Yes
hierarchy	string	Hierarchy or path of the modifier in the avatar	Yes
value	valueObject	Values associated with the modifier	No

Value Object

Key	Type	Description	Mandatory
name	string	Name of the value	No
type	string	Type of the value (e.g., range, discrete)	No
from	string	Lower limit of the value range	No
to	string	Upper limit of the value range	No
discrete	array of string	List of discrete values the modifier can take	No

Example

"avatar": {
    "class": "Elf",
    "generation": "1.0",
    "rootBone": "Hips",
    "modifiers": [
        {
            "name": "BodyType",
            "type": "Morph",
            "hierarchy": "Body",
            "value": {
                "name": "Body Preset",
                "type": "discrete",
                "discrete": ["Athletic", "Curvy", "Slim", "Heavy"]
            }
        },
        {
            "name": "HairStyle",
            "type": "Mesh",
            "hierarchy": "Head.Hair",
            "value": {
                "name": "Hair Preset",
                "type": "discrete",
                "discrete": ["Short", "Medium", "Long", "Bald"]
            }
        },
        {
            "name": "EyeColor",
            "type": "Color",
            "hierarchy": "Head.Eyes",
            "value": {
                "name": "Color",
                "type": "range",
                "from": "#000000",
                "to": "#FFFFFF"
            }
        }
    ]
}