Version: 2022.3
Language : English
The Animator Controller Asset
Animation State Machines

The Animator Window

The Animator Window allows you to create, view and modify Animator Controller assets.

The Animator Window showing a new empty Animator Controller asset
The Animator Window showing a new empty Animator Controller asset

The Animator window has two main sections: the main gridded layout area, and the left-hand Layers & Parameters pane.

The layout area of the Animator window
The layout area of the Animator window

The main section with the dark grey grid is the layout area. You can use this area to create, arrange and connect states in your Animator ControllerControls 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
.

You can right-click on the grid to create a new state node. Use the middle mouse button or Alt/Option drag to pan the view around. Click to select state nodes to edit them, and click & drag state nodes to rearrange the layout of your state machineThe set of states in an Animator Controller that a character or animated GameObject can be in, along with a set of transitions between those states and a variable to remember the current state. The states available will depend on the type of gameplay, but typical states include things like idling, walking, running and jumping. More info
See in Glossary
.

The Parameters view, with two example parameters created.
The Parameters view, with two example parameters created.

The left-hand pane can be switched betwen Parameters view and Layers view. The parameters view allows you to create, view and edit the Animator Controller Parameters. These are variables you define that act as inputs into the state machine. To add a parameter, click the Plus icon and select the parameter type from the pop up menu. To delete a parameter, select the parameter in the lists and press the delete key (on macOS use fn-Delete to delete the selected parameter).

The Layers view
The Layers view

When the left-hand pane is switched to Layers view, you can create, view and edit layersLayers in Unity can be used to selectively opt groups of GameObjects in or out of certain processes or calculations. This includes camera rendering, lighting, physics collisions, or custom calculations in your own code. More info
See in Glossary
within your Animator Controller. This allows you to have multiple layers of animation within a single animation controller working at the same time, each controlled by a separate state machine. A common use of this is to have a separate layer playing upper-body animations over a base layer that controls the general movement animations for a character.

To add a layer, click the plus icon. To delete a layer, select the layer and press the delete key.

The Layers & Parameters hide icon
The Layers & Parameters hide icon

Clicking the “eye” icon on or off will show or hide the Parameters & Layers side-pane, allowing you more room to see and edit your state machine.

The hierarchical breadcrumb location
The hierarchical breadcrumb location

The “breadcrumb” hierarchical location within the current state machine. States can contain sub-states and treesA GameObject and associated Component that allows you to add tree assets to your Scene. You can add branch levels and leaves to trees in the Tree Inspector window. More info
See in Glossary
and these structures can be nested repeatedly. When drilling down into sub states, the hierarchy of parent states and the current state being viewed is listed here. Clicking on the parent states allows you to jump back up to parent states or go straight back to the base layer of the state machine.

The lock icon
The lock icon

Enabling the lock icon will keep the Animator Window focused on the current state machine. When the lock icon is off, clicking a new animator asset or a Game Object with an animator componentA component on a model that animates that model using the Animation system. The component has a reference to an Animator Controller asset that controls the animation. More info
See in Glossary
will switch the Animator Window to show that item’s state machine. Locking the window allows you to keep the Animator window showing the same state machine, regardless of which other assets or Game Objects are selected.

The Animator Controller Asset
Animation State Machines