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

# Properties reference

Every custom property the rig defines, with its ID, default and range.

The rig defines **205 custom properties**: 97 toggles, 42 sliders, 27 integers, 21 dropdowns and 18 colors. The **ID** is the name of the custom property on the rig, which is what you see in Blender's property editor, in drivers and in scripts.

{% hint style="info" %}
The properties are stored on dedicated bones of the armature, one bone per section: Controls, Bones, Customize and Display. The panel reads and writes them there.
{% endhint %}

## Controls

| ID                                                                                                                                                  | Label                    | Type  | Default              | Range / options                                                               |
| --------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ | ----- | -------------------- | ----------------------------------------------------------------------------- |
| `ik_fk_autokey`                                                                                                                                     | IK-FK AutoKey            | bool  | On                   |                                                                               |
| `face_rig`                                                                                                                                          | Face Rig                 | bool  | On                   |                                                                               |
| `eye_toggle`                                                                                                                                        | Eye Toggle               | bool  | On                   |                                                                               |
| `mouth_toggle`                                                                                                                                      | Mouth Toggle             | bool  | On                   |                                                                               |
| `mouth_m`                                                                                                                                           | Mouth M                  | bool  | On                   |                                                                               |
| `mouth_f`                                                                                                                                           | Mouth F                  | bool  | Off                  |                                                                               |
| `cartoon_eyes`                                                                                                                                      | Cartoon Eyes             | bool  | Off                  |                                                                               |
| `cartoon_mouth`                                                                                                                                     | Cartoon Mouth            | bool  | Off                  |                                                                               |
| `eyetracker`                                                                                                                                        | Eyetracker               | bool  | Off                  |                                                                               |
| `teeth_follow`                                                                                                                                      | Teeth Follow             | bool  | On                   |                                                                               |
| `head_squash`                                                                                                                                       | Head Squash              | bool  | Off                  |                                                                               |
| `global_head_rotation`                                                                                                                              | Global Head Rotation     | bool  | Off                  |                                                                               |
| `texture_deform`                                                                                                                                    | Texture Deform           | bool  | Off                  |                                                                               |
| `body_squash`                                                                                                                                       | Body Squash              | bool  | Off                  |                                                                               |
| `left_arm_stretch`                                                                                                                                  | Left Arm Stretch         | bool  | On                   |                                                                               |
| `right_arm_stretch`                                                                                                                                 | Right Arm Stretch        | bool  | On                   |                                                                               |
| `left_arm_squash`                                                                                                                                   | Left Arm Squash          | bool  | Off                  |                                                                               |
| `right_arm_squash`                                                                                                                                  | Right Arm Squash         | bool  | Off                  |                                                                               |
| `left_fingers`                                                                                                                                      | Left Fingers             | bool  | Off                  |                                                                               |
| `right_fingers`                                                                                                                                     | Right Fingers            | bool  | Off                  |                                                                               |
| `individual_finger_parents`                                                                                                                         | Individual Fingers       | bool  | Off                  |                                                                               |
| `ik_disable_arms`                                                                                                                                   | IK Disable Arms          | bool  | Off                  |                                                                               |
| `left_leg_stretch`                                                                                                                                  | Left Leg Stretch         | bool  | On                   |                                                                               |
| `right_leg_stretch`                                                                                                                                 | Right Leg Stretch        | bool  | On                   |                                                                               |
| `left_leg_squash`                                                                                                                                   | Left Leg Squash          | bool  | Off                  |                                                                               |
| `right_leg_squash`                                                                                                                                  | Right Leg Squash         | bool  | Off                  |                                                                               |
| `ik_disable_legs`                                                                                                                                   | IK Disable Legs          | bool  | Off                  |                                                                               |
| `left_arm_ik`                                                                                                                                       | Left Arm IK              | float | 1                    | 0 to 1                                                                        |
| `right_arm_ik`                                                                                                                                      | Right Arm IK             | float | 1                    | 0 to 1                                                                        |
| `left_fingers_ik`                                                                                                                                   | Left Fingers IK          | float | 1                    | 0 to 1                                                                        |
| `right_fingers_ik`                                                                                                                                  | Right Fingers IK         | float | 1                    | 0 to 1                                                                        |
| `left_leg_ik`                                                                                                                                       | Left Leg IK              | float | 1                    | 0 to 1                                                                        |
| `right_leg_ik`                                                                                                                                      | Right Leg IK             | float | 1                    | 0 to 1                                                                        |
| `left_arm_ik_parent`, `right_arm_ik_parent`                                                                                                         | Arm IK Parent            | enum  | Arm Upper IK Control | See [IK Parent Tree](/jabe-rig-wiki/documentation/features/ik-parent-tree.md) |
| `left_fingers_ik_parent`, `right_fingers_ik_parent`                                                                                                 | Fingers IK Parent        | enum  | Fingers Master       | See [IK Parent Tree](/jabe-rig-wiki/documentation/features/ik-parent-tree.md) |
| `left_fingers_master_ik_parent`, `right_fingers_master_ik_parent`                                                                                   | Fingers Master IK Parent | enum  | Arm IK               | See [IK Parent Tree](/jabe-rig-wiki/documentation/features/ik-parent-tree.md) |
| `left_leg_ik_parent`, `right_leg_ik_parent`                                                                                                         | Leg IK Parent            | enum  | Root                 | See [IK Parent Tree](/jabe-rig-wiki/documentation/features/ik-parent-tree.md) |
| `left_index_ik_parent`, `left_mid_ik_parent`, `left_ring_ik_parent`, `left_pinky_ik_parent`, `left_thumb_ik_parent` and the same five with `right_` | Per-finger IK Parent     | enum  | Fingers Master       | Used instead of the shared Fingers parent when **Individual Fingers** is on   |

## Bones

All are toggles that show or hide a bone collection. See [Bones](/jabe-rig-wiki/documentation/features/bones.md) for what each one controls.

| ID                                                                                                                                                                                                                                                                                                                                                               | Default |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| `head`, `facial`, `facial_tweaks`, `body`, `left_arm`, `right_arm`, `left_arm_ik_bones`, `right_arm_ik_bones`, `left_leg`, `right_leg`, `left_leg_ik_bones`, `right_leg_ik_bones`, `tongue_bones`, `tongue_ik`, `fingers_master_control`, `extras`                                                                                                               | On      |
| `eye_tweaks`, `tongue_tweaks`, `tongue_fk`, `body_tweaks`, `left_arm_fk`, `right_arm_fk`, `left_arm_tweaks`, `right_arm_tweaks`, `left_arm_fingers`, `right_arm_fingers`, `left_fingers_ik_bones`, `right_fingers_ik_bones`, `left_fingers_fk_bones`, `right_fingers_fk_bones`, `left_leg_fk`, `right_leg_fk`, `left_leg_tweaks`, `right_leg_tweaks`, `internal` | Off     |

## Customize

| ID                                                                                               | Label                    | Type  | Default | Range / options                                 |
| ------------------------------------------------------------------------------------------------ | ------------------------ | ----- | ------- | ----------------------------------------------- |
| `arm_type`                                                                                       | Arm Type                 | enum  | Steve   | Steve, Alex, Slim                               |
| `bend_smoothness`                                                                                | Bend Smoothness          | float | 1       | 0 to 1                                          |
| `face_fluid`                                                                                     | Face Fluid               | float | 1       | 0 to 1                                          |
| `round_jaw`                                                                                      | Round Jaw                | float | 0       | 0 to 1                                          |
| `teeth_sharp`                                                                                    | Teeth Sharp              | float | 0       | 0 to 1                                          |
| `eyebrows_thickness`                                                                             | Eyebrows Thickness       | float | 1       | -1 to 1                                         |
| `eye_depth`                                                                                      | Eye Depth                | float | 1       | 1 to 2                                          |
| `mouth_depth`                                                                                    | Mouth Depth              | float | 1       | 1 to 2                                          |
| `teeth_depth`                                                                                    | Teeth Depth              | float | 1       | 1 to 2                                          |
| `breasts`                                                                                        | Breasts                  | float | 0       | 0 to 1                                          |
| `tongue`                                                                                         | Tongue                   | bool  | On      |                                                 |
| `lipstick`                                                                                       | Lipstick                 | bool  | Off     |                                                 |
| `eyelashes`                                                                                      | Eyelashes                | enum  | None    | None, Eyelashes 1, Custom                       |
| `eyes_emotions`                                                                                  | Eyes Emotions            | enum  | None    | None, Heart, Money, Happy, Dizzy, X, ><, Custom |
| `anger`                                                                                          | Anger                    | bool  | Off     |                                                 |
| `head_gradient`                                                                                  | Head Gradient            | float | 0       | 0 to 1                                          |
| `blush`                                                                                          | Blush                    | float | 0       | 0 to 1                                          |
| `left_tear`, `right_tear`                                                                        | Left Tear, Right Tear    | float | 0       | 0 to 1                                          |
| `left_shocked`, `right_shocked`                                                                  | Shocked                  | bool  | Off     |                                                 |
| `left_frown`, `right_frown`                                                                      | Frown                    | bool  | Off     |                                                 |
| `left_eyebrow_frown`, `right_eyebrow_frown`                                                      | Eyebrow Frown            | bool  | Off     |                                                 |
| `left_eyelid_mid`, `right_eyelid_mid`                                                            | Mid Eyelid               | bool  | Off     |                                                 |
| `left_eyelid_side`, `right_eyelid_side`                                                          | Side Eyelid              | bool  | Off     |                                                 |
| `left_eyelid_mid_bot`, `right_eyelid_mid_bot`                                                    | Mid Bot Eyelid           | bool  | Off     |                                                 |
| `left_eyelid_side_bot`, `right_eyelid_side_bot`                                                  | Side Bot Eyelid          | bool  | Off     |                                                 |
| `left_tired`, `right_tired`                                                                      | Tired                    | bool  | Off     |                                                 |
| `left_eyebag`, `right_eyebag`                                                                    | Eyebag                   | bool  | Off     |                                                 |
| `hip_taper`                                                                                      | Hip Taper                | float | 0       | 0 to 1                                          |
| `upper_body_taper`, `lower_body_taper`                                                           | Upper / Lower Body Taper | float | 0       | -1 to 1                                         |
| `left_arm_upper_taper`, `left_arm_lower_taper`, `right_arm_upper_taper`, `right_arm_lower_taper` | Arm Tapers               | float | 0       | -1 to 1                                         |
| `left_leg_upper_taper`, `left_leg_lower_taper`, `right_leg_upper_taper`, `right_leg_lower_taper` | Leg Tapers               | float | 0       | -1 to 1                                         |
| `specular`                                                                                       | Specular                 | float | 0       | 0 to 1                                          |
| `eye_specular`                                                                                   | Eye Specular             | float | 0       | 0 to 1                                          |
| `cartoon_mouth_specular`                                                                         | Cartoon Mouth Specular   | float | 0       | 0 to 1                                          |
| `pupil`                                                                                          | Pupil                    | bool  | On      |                                                 |
| `gradient`                                                                                       | Gradient                 | bool  | Off     |                                                 |
| `eye_texture`                                                                                    | Eye Texture              | bool  | Off     |                                                 |
| `sparkle_top`, `sparkle_bot`                                                                     | Sparkle Top, Sparkle Bot | bool  | On      |                                                 |
| `sparkles_emission`                                                                              | Sparkles Emission        | float | 0       | 0 to 1000                                       |
| `sparkle_top_x`, `sparkle_top_y`                                                                 | Sparkle Top X, Y         | float | 0.75    | -0.2 to 1.2                                     |
| `sparkle_bot_x`                                                                                  | Sparkle Bot X            | float | 0.82    | -0.2 to 1.2                                     |
| `sparkle_bot_y`                                                                                  | Sparkle Bot Y            | float | 0.44    | -0.2 to 1.2                                     |
| `sparkle_top_size`                                                                               | Sparkle Top Size         | float | 0.15    | 0 to 1                                          |
| `sparkle_bot_size`                                                                               | Sparkle Bot Size         | float | 0.075   | 0 to 1                                          |
| `eye_emission_l`, `eye_emission_r`                                                               | Eye Emission L, R        | float | 0       | 0 to 1                                          |
| `eyebrow_single_color_bool`                                                                      | Eyebrows Single Color    | bool  | On      |                                                 |
| `round_cartoon_tongue`                                                                           | Round Cartoon Tongue     | bool  | On      |                                                 |

### Colors

All colors are RGBA.

| ID                                     | Label                      | Default                 |
| -------------------------------------- | -------------------------- | ----------------------- |
| `top_eye_color`                        | Top Eye Color              | (0.4, 0, 0.8, 1)        |
| `bot_eye_color`                        | Bot Eye Color              | (0.5, 0, 0.88, 1)       |
| `eyelashes_color`                      | Eyelashes                  | (0, 0, 0, 1)            |
| `pupil_color`                          | Pupil Color                | (0, 0, 0, 0)            |
| `eyewhite_color`                       | Eyewhite Color             | (1, 1, 1, 1)            |
| `eyebrow_single_color`                 | Eyebrow Single Color       | (0.02, 0.009, 0.002, 1) |
| `eyebrow_color_1` to `eyebrow_color_4` | Eyebrow Color 1 to 4       | (0.02, 0.009, 0.002, 1) |
| `cartoon_mouth_color`                  | Cartoon Mouth Color        | (0.65, 0.4, 0.29, 1)    |
| `cartoon_mouth_inner_color`            | Cartoon Mouth Inner Color  | (0.65, 0.31, 0.31, 1)   |
| `cartoon_mouth_tongue_color`           | Cartoon Mouth Tongue Color | (1, 0.36, 0.4, 1)       |
| `cartoon_mouth_teeth_color`            | Cartoon Mouth Teeth Color  | (1, 1, 1, 1)            |
| `emotions_color`                       | Emotions                   | (1, 1, 1, 1)            |
| `tongue_color`                         | Tongue Color               | (1, 0.4, 0.5, 1)        |
| `lipstick_color_upper`                 | Upper Lipstick             | (0.038, 0.014, 0.1, 1)  |
| `lipstick_color_lower`                 | Lower Lipstick             | (0.15, 0.04, 0.42, 1)   |

## Display

| ID                                                                                                                                 | Label                     | Type | Default                      | Range  |
| ---------------------------------------------------------------------------------------------------------------------------------- | ------------------------- | ---- | ---------------------------- | ------ |
| `head_visibility`, `body_visibility`, `left_arm_visibility`, `right_arm_visibility`, `left_leg_visibility`, `right_leg_visibility` | Visibility toggles        | bool | On                           |        |
| `auto_playback_subdivision`                                                                                                        | Auto Playback Subdivision | bool | Off                          |        |
| `<part>_subdivision_viewport`                                                                                                      | Viewport level            | int  | 1 (eyes and tongue: 2)       | 0 to 4 |
| `<part>_subdivision_playback`                                                                                                      | Playback level            | int  | 0                            | 0 to 4 |
| `<part>_subdivision_render`                                                                                                        | Render level              | int  | 2 (head 3, eyes 3, tongue 4) | 0 to 4 |

`<part>` is one of `head`, `body`, `left_arm`, `right_arm`, `left_leg`, `right_leg`, `eyebrows`, `eyes` or `tongue`. See [Display](/jabe-rig-wiki/documentation/features/display.md) for the default of each part.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://jabe.gitbook.io/jabe-rig-wiki/documentation/reference/properties-reference.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
