> For the complete documentation index, see [llms.txt](https://scenegroup.gitbook.io/cavalry/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://scenegroup.gitbook.io/cavalry/nodes/utilities/rig-control.md).

# Rig Control

A 2d controller (or joystick by any other name).

**Active** - toggle the **Control** mode.

**Control** - this UI is dependent on the **Active** state:

* **Active unchecked** - This is the mode you set up your rig in. The five dots on the joystick represent the five keyframes necessary to set up the rig. Clicking each dot will move the timeline to the following corresponding frames:

  * Centre (neutral pose) - Frame 0
  * Left - Frame 1
  * Right - Frame 2
  * Top - Frame 3
  * Bottom - Frame 4

* **Active checked** - this is the mode you use to animate your rig in. Moving the dot translates between the poses set in **Inactive mode**.

{% hint style="info" %}
Example workflow:

1. Create a [Basic Shape](/cavalry/nodes/shapes/basic-shape.md) and a **Rig Control**.
2. [Connect](/cavalry/getting-started/key-concepts/connections.md) ***rigControl.id*** > ***basicShape.position***
3. A new [Keyframe Layer](/cavalry/user-interface/menus/window-menu/scene-window/keyframe-layers.md) will be created and 5 keys set for you on frames 0-4.
4. Set the following keys on the Basic Shape for Position \[x,y]:
   1. Frame 0 = 0, 0
   2. Frame 1 = -50, 0
   3. Frame 2 = 50, 0
   4. Frame 3 = 0, 50
   5. Frame 4 = 0, -50
5. Check **Active** on the Rig Control.
6. Move the dot on the Control.
7. To animate the rig set the [Keyframe Layer](/cavalry/user-interface/menus/window-menu/scene-window/keyframe-layers.md) to **Default** and set [keyframes](/cavalry/user-interface/menus/window-menu/attribute-editor/untitled/control-rows.md#setting-keyframes) by using the x, y controls.
   {% endhint %}

There's a demo scene in in the [Example Files](/cavalry/getting-started/example-files.md) if you'd rather dive straight in.:slight\_smile: 

![A simple head rig.](https://1676825895-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LT2-S1m8aSPAI_Gg3Q1%2F-LbV0HxE458vqvdRDkUT%2F-LbV2t041amBU5Ds_j7Q%2FrigControl3.gif?alt=media\&token=616832b6-3b60-4a4b-9faf-b5d10ff85a17)