Version: 2022.1
Avatar Muscle & Settings tab
Human Template window

Avatar Mask window

Switch to Scripting

There are two ways to define which parts of your animation should be masked:

Humanoid body selection

If your animation uses a Humanoid AvatarAn interface for retargeting animation from one rig to another. More info
See in Glossary
, you can select or deselect portions of the simplified humanoid body diagram to indicate where to mask the animation:

Defining an Avatar Mask using the Humanoid body
Defining an Avatar Mask using the Humanoid body

The body diagram groups body parts into these portions:

  • Head
  • Left Arm
  • Right Arm
  • Left Hand
  • Right Hand
  • Left Leg
  • Right Leg
  • Root (denoted by the “shadow” under the feet)

To include animation from one of these body portions, click the Avatar diagram for that portion until it appears as green. To exclude animation, click the body portion until it appears red. To include or exclude all, double-click the empty space surrounding the Avatar.

You can also toggle Inverse Kinematics__ (IK)__ for hands and feet, which determines whether or not to include IK curves in animation blending.

Transform selection

Alternatively, if your animation does not use a Humanoid Avatar, or if you want more detailed control over which individual bones are masked, you can select or deselect portions of the Model’s hierarchy:

  1. Assign a reference to the Avatar whose transform you would like to mask.
  2. Click the Import Skeleton button. The hierarchy of the avatar appears in the inspectorA Unity window that displays information about the currently selected GameObject, asset or project settings, allowing you to inspect and edit the values. More info
    See in Glossary
    .
  3. You can check each bone in the hierarchy to use as your mask.
Defining an avatar mask using the Transform method
Defining an avatar mask using the Transform method

Mask assets can be used in Animator ControllersControls animation through Animation Layers with Animation State Machines and Animation Blend Trees, controlled by Animation Parameters. The same Animator Controller can be referenced by multiple models with Animator components. More info
See in Glossary
, when specifying Animation LayersAn Animation Layer contains an Animation State Machine that controls animations of a model or part of it. An example of this is if you have a full-body layer for walking or jumping and a higher layer for upper-body motions such as throwing an object or shooting. The higher layers take precedence for the body parts they control. More info
See in Glossary
to apply masking at runtime, or in the import settings of of your animation files to apply masking during to the import animation.

A benefit of using Masks is that they tend to reduce memory overheads since body parts that are not active do not need their associated animation curvesAllows you to add data to an imported clip so you can animate the timings of other items based on the state of an animator. For example, for a game set in icy conditions, you could use an extra animation curve to control the emission rate of a particle system to show the player’s condensing breath in the cold air. More info
See in Glossary
. Also, the unused curves need not be calculated during playback which will tend to reduce the CPU overhead of the animation.

Avatar Muscle & Settings tab
Human Template window