# CVR Avatar

The main component for a ChilloutVR avatar. **This is required for an avatar upload.** Some options listed below may be missing for generic (non-humanoid) avatars.

<p class="callout warning">This component will automatically add the required [CVR Asset Info](https://chillout.wiki/books/content-creation-kit/page/cvr-asset-info "CVR Asset Info") component for you.   
You may run into issues uploading if you've manually added the CVR Asset Info script before the CVR Avatar component!</p>

#### **Generic Avatar Settings**

<table border="1" id="bkmrk-property-description" style="border-collapse: collapse; width: 100%; height: 186.375px;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Property**</td><td style="height: 29.7969px;">**Description**</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">View Position 🟢</td><td style="height: 46.5938px;">Controls your avatars viewpoint in-game. This should be between both eyes.</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">Voice Position 🔴</td><td style="height: 46.5938px;">Controls your avatars voice position in-game. This should be on your avatars mouth.  
</td></tr><tr style="height: 63.3906px;"><td style="height: 63.3906px;">Voice Parent</td><td style="height: 63.3906px;">The humanoid bone which your Voice Position is attached to. It will follow the bone's position while you move your avatar around in world space. Head, Left Hand, Right Hand, Hips.  
</td></tr></tbody></table>

#### **Avatar Customization**

##### Animation Overrides

The Override Controller used to specify which Controller and Overrides to use on the avatar.  
  
You can use this to quickly override animations on the default Controller included with the CCK, or alternatively reference your own custom Controller to use on the avatar instead.

#### **Blinking and Visemes**

You can configure your avatar to have eye movement, blinking and voice activated blendshapes called visemes.

##### Face Mesh

The Skinned Mesh Renderer to use for automatic blinking and visemes.

##### Use Eye Movement

Enables automatic eye movement that can focus on nearby players.

<p class="callout warning">This requires eye bones to be mapped in your avatars Humanoid configuration!</p>

<p class="callout info">This property is animatable during runtime.  
</p>

##### Use Blink Blendshapes

Enables automatic blinking using the specified blendshapes. You are able to specify up to four blendshapes to use at once.  
Any unneeded blendshapes can be left as `-none-`.

<p class="callout info">This property is animatable during runtime.</p>

##### Use Lip Sync

Enables lip sync to be used on your avatar. You can choose between using Visemes, Single Blendshape, and Jaw Bone.

<p class="callout info">This property is animatable during runtime. It must be enabled by default when using the Visemes Lip Sync Mode.</p>

##### Lip Sync Mode

- Visemes 
    - Uses multiple blendshapes to map human speech to mouth movement.  
        You can find examples and references from the [Oculus Developer Viseme Reference Documentation](https://developer.oculus.com/documentation/unity/audio-ovrlipsync-viseme-reference/).
- Single Blendshape 
    - Uses a single blendshape to drive mouth movement.
- Jaw bone 
    - Uses the mapped jaw bone in your avatars Humanoid configuration to drive mouth movement.

##### Viseme Smoothing

A value between 1-100 to determine the smoothing of the Visemes Lip Sync Mode.  
Lower values will snap to the currently recognized Viseme, and higher values will slowly smooth to it.

#### **Advanced Tagging**

With the advanced tagging feature, you can set content filter tags for specific gameobjects on your avatar.   
Press the `+` button to add an entry to your **Tagged Gameobjects** list.

##### Tags

List of content tags you want for this particular gameobject. You can tag Loud Audio, Long Range Audio, Screen Fx, Flashing Colors, Flashing Lights, Violence, Gore, and Horror.

##### GameObject

The specific gameobject you would like to add the above tags to.

##### Fallback GO (GameObject)

A fallback gameobject to use instead if the above gameobject is hidden by the content filter.

<p class="callout warning">If you are using the Advanced Tagging System, you still need to Tag your Avatar appropriately on the upload screen!</p>

#### **Advanced Settings**