Standardization is required for collaboration and shared assets. This is a proposal made by Colin The Cat which standardizes a list of Dynamic Variables on the "Avatar" namespace to make avatar systems interoperable and portable and enables artists to create assets which can easily be installed on avatars without using any developer tools.
Avatar systems are anything that goes on top of an avatar base. This includes ProtoFlux logic and other assets such as clothing or body parts.
All variables must be defined including their namespace to avoid them accidentally binding to the wrong namespace: Avatar/VariableName. The namespace must not rely on non-direct binding of variables.
| Name | Type | Purpose |
|---|---|---|
Root |
Slot |
Root slot of the avatar. |
User |
User |
The user that has the avatar equipped as assigned by the Avatar User Reference Assigner. |
HasUser |
bool |
If the avatar is currently equipped. |
IsAway |
bool |
If the user of the avatar is shown as away. |
Base |
String |
Name of the avatar base. Examples: Davali, Mayu.
|
Name |
String |
Name of the avatar slot. |
Bone.Name |
Slot |
All bones of the rig using the original bone names. |
BodyNode.Name |
Slot |
All armature body nodes using Body Node names. |
BodyNode.Name.Bone |
Slot |
The associated fake bone, if one is being used. |
BodyNode.Name.Hidden |
bool |
If the body part should be hidden. |
Proxy.Name |
Slot |
Proxies using the Body Node names. |
RigCollidersEnabled |
bool |
As set by Component:VRIKAvatar rigCollidersEnabledStates.
|
Renderers |
Slot |
All renderers are children of this slot. |
Renderer.Mesh |
SkinnedMeshRendererMeshRenderer |
|
Renderer.Mesh.Enabled |
bool |
Defaults to true.
|
Material.Name |
IAssetProvider<Material> |
|
Material.Name.Away |
IAssetProvider<Material> |
Material version when IsAway is true.
|
Menu |
Slot |
Radial menu items root slot. |
Menu |
colorX |
Avatar menu color. |
Menu |
IAssetProvider<Sprite> |
Avatar menu icon. |
Systems |
Slots |
All systems are children of this slot. |
Voice |
IWorldAudioDataSource |
Assigned by Avatar Voice Source Assigner. |
VisemeAnalyzer |
VisemeAnalyzer |
|
VisemeAnalyzer.Strength |
float |
Defaults to 1. |
VisemeAnalyzer.VoiceOverride |
IWorldAudioDataSource |
Defaults to Voice.
|
Systems
Avatar systems can be installed by moving their root slot under Avatar/Systems. They can be deleted by moving them out of the avatar and deleting them after at least 5 ticks. This ensures that all driven parents are moved under the system slot.
Systems can install slots anywhere on the avatar by creating a Dynamic Reference Variable Driver for the parent field of the slot that needs to be somewhere outside of the system's hierarchy. The driver needs to stay under the system's hierarchy and the default value needs to be under it as well to ensure that all slots are removed from the avatar when the system is moved out. It is also recommended to add Destroy Proxies for all slots which are moved outside of the system's hierarchy.
A system can be used to store any customizations such as custom materials (including textures), avatar slot name, menu color/icon by creating a dynamic field on an asset loader (for assets) or a dynamic reference variable which have override on link enabled.
Tools
The process of creating the dynamic variables can be partially automated. A tool for creating them and for moving and installing systems can be found at the following record:
resrec:///U-1QbdepR26LI/R-7dc75818-8a95-4a6d-b3b8-3a9010cbf0af
Standard proposals
Avatar2 proposal
Avatar2 is a dynamic variable often used by 989onan that is used specifically for items that like to make slots that "Jump" from inside of it to slots on the avatar. Issue with these items is that they loose their content that is inside when saved via grabbing, due to the jumpiness nature of their slot hierarchy. That is why these would use "Avatar2" with a dynamic variable space of such on the grab anchor slot. The item will place the slots properly when in avatar hierarchy, but put them back when taken out. This helps for items like hats that change color when held, but parent themselves to the head when their driver flux/Component is in avatar hierarchy (A mix use case of Avatar and Avatar2)