Avatar

Avatars are virtual representations of actors in a virtual environment, such as a metaverse or a video game.

The Avatar Object is a data structure used to represent the appearance of a character in an application or game. It consists of three main components: character, appearance, and outfit. The character component represents the base characteristics of the character, while the appearance and outfit components modify the character's appearance with specific features and clothing.

Data structure

Field	Type	Description	Mandatory	Reference
charater	CharacterObject	Object setup of a character
appearance	Array of AppearanceObject	Appearance of a character
outfit	Array of OutfitObject	Outfit of a character

Character object

The Character Object represents the base characteristics of the character. It contains an object setup of a character and a set of modifiers in key-value pairs. The modifiers are Avatar-Record specific and allow modifications to the original character.

Field	Type	Description	Mandatory	Reference
avatarObject	CDID	Object of a character		Object.virtual.avatar
modifiers	KeyValues	Modifiers in key-value pairs

Modifiers are Avatar-Record specific and allow modifications of original charater. The modifiers property in each component can be used to adjust the values of the object. For example, the muscleMass modifier in the character component can be set to a value between 0 and 1 to adjust the character's level of muscularity.

Appearance object

The Appearance Object represents modifications to the character's appearance, such as a different hairstyle or beard. It contains a looks object, which represents the modified appearance, and a set of modifiers in key-value pairs that modify the looks object.

Field	Type	Description	Mandatory	Reference
lookObject	CDID	Looks object like hairstyle or beard		Object.virtual.avatar.component
modifiers	KeyValues	Modifiers of a look object in key-value pairs

Outfit object

The Outfit Object represents clothing and accessories worn by the character. It contains an object setup of the outfit item and a set of modifiers in key-value pairs that modify the outfit item.

Field	Type	Description	Mandatory	Reference
itemObject	CDID	Object of a outfit item		Object.virtual.avatar.component
modifiers	KeyValues	Modifiers of outfit item in key-value pairs

Example

Here's an example of an Avatar Object:

Example of an avatar

"actor": {
    "name":"John Smith",
    "shortName":"JohnS",
    "headline":"Master of the universe",
    "resources":[],
    "proxy":{
        "source":"4F7D9D4F-8648-4AA4-B05A-50EDD69A580E",
        "platform":"ALL.ART",
        "avatar":{
            "character": {
                "avatarObject": "D86F2659-6B79-48E5-BC7A-F5E85A5CA875",
                "modifiers": {
                    "skinColor": "#FFFEFA",
                    "muscleMass": 0.8
                }
            },
            "appearance": [
                {
                    "lookObject": "EF5F3124-580C-4C75-BD79-AB05BDEE6DCA",
                    "modifiers": {
                        "color": "#FFFF00"
                    }
                },
                {
                    "lookObject": "88ABE8B6-DF85-4D7D-9B71-3B3E3D6B146D",
                    "modifiers": {
                        "color": "#FFA500"
                    }
                }
            ],
            "outfit": [
                {
                    "itemObject": "73F60C1B-41F6-478B-8813-2CBFE3FF0E60",
                    "modifiers": {
                        "color": "#FFDDAA"
                    }
                },
                {
                    "itemObject": "AC9C43E8-1AF1-45CB-A961-6F28E6C8BDEE"
                }
            ]
        }
    }
}