# llGetAnimationOverride

*LSL function*

```lsl
string string llGetAnimationOverride(string anim_state);
```

- `string anim_state`: Animation state string to query.

- Returns: `string`
- Energy: 10
- Permission: `PERMISSION_OVERRIDE_ANIMATIONS,PERMISSION_TRIGGER_ANIMATION`

Returns a string representing the name of the animation currently overriding the specified anim_state. Requires the PERMISSION_OVERRIDE_ANIMATIONS or PERMISSION_TRIGGER_ANIMATION runtime permission.

Returns a [string](https://wiki.secondlife.com/wiki/string) that is the name of the animation that is being used for the specified animation state (**anim_state**).

```lsl title="How to use" frame="terminal"
string result = llGetAnimationOverride("");
```

## Specification

****

| Value | Type | Description | Default |
| --- | --- | --- | --- |
| "Crouching" | State |  | crouch |
| "CrouchWalking" | State |  | crouchwalk |
| "Falling Down" | State |  | falldown |
| "Flying" | State |  | fly |
| "FlyingSlow" | State | Transition between hovering and forward flight. | flyslow |
| "Hovering" | State |  | hover |
| "Hovering Down" | State |  | hover_down |
| "Hovering Up" | State |  | hover_up |
| "Jumping" | State | While still in the air during a jump. | jump |
| "Landing" | Transition | When landing from a jump. | land |
| "PreJumping" | Transition | At the beginning of a jump. | prejump |
| "Running" | State |  | run |
| "Sitting" | State | Sitting on an object (and linked to it). | sit |
| "Sitting on Ground" | State | Sitting, but not linked to an object.[^wiki-fe736d] | sit_ground_constrained |
| "Standing" | State |  | stand |
| "Standing Up" | Transition | After falling a great distance. Sometimes referred to as Hard Landing. | standup |
| "Striding" | State | When the avatar is stuck on the edge of an object or on top of another avatar. | stride |
| "Soft Landing" | Transition | After falling a small distance. | soft_land |
| "Taking Off" | State |  | hover_up |
| "Turning Left" | State |  | turnleft |
| "Turning Right" | State |  | turnright |
| "Walking" | State |  | walk |

[^wiki-fe736d]: "Sit down" on the avatar context menu allows ground sits anywhere: atop the terrain, objects or even in the air.

## Examples

<details open>
<summary>Example 1</summary>

```lsl collapse={4-17}
//    llGetAnimationOverride Example
//    A Script to check the animation Stats on
//  all available overridable animations.
//    By Kanashio Koroshi and Pedro Oval

default
{
    state_entry()
    {
        llRequestPermissions(llGetOwner(),
            PERMISSION_OVERRIDE_ANIMATIONS);
    }

    run_time_permissions(integer permissions)
    {
        if (permissions & PERMISSION_OVERRIDE_ANIMATIONS)
        {
            llOwnerSay("Listing Overridden Animations");
            llOwnerSay("Crouching: " + llGetAnimationOverride("Crouching"));
            llOwnerSay("CrouchWalking: " + llGetAnimationOverride("CrouchWalking"));
            llOwnerSay("Falling Down: " + llGetAnimationOverride("Falling Down"));
            llOwnerSay("Flying: " + llGetAnimationOverride("Flying"));
            llOwnerSay("FlyingSlow: " + llGetAnimationOverride("FlyingSlow"));
            llOwnerSay("Hovering: " + llGetAnimationOverride("Hovering"));
            llOwnerSay("Hovering Down: " + llGetAnimationOverride("Hovering Down"));
            llOwnerSay("Hovering Up: " + llGetAnimationOverride("Hovering Up"));
            llOwnerSay("Jumping: " + llGetAnimationOverride("Jumping"));
            llOwnerSay("Landing: " + llGetAnimationOverride("Landing"));
            llOwnerSay("PreJumping: " + llGetAnimationOverride("PreJumping"));
            llOwnerSay("Running: " + llGetAnimationOverride("Running"));
            llOwnerSay("Sitting: " + llGetAnimationOverride("Sitting"));
            llOwnerSay("Sitting on Ground: " + llGetAnimationOverride("Sitting on Ground"));
            llOwnerSay("Standing: " + llGetAnimationOverride("Standing"));
            llOwnerSay("Standing Up: " + llGetAnimationOverride("Standing Up"));
            llOwnerSay("Striding: " + llGetAnimationOverride("Striding"));
            llOwnerSay("Soft Landing: " + llGetAnimationOverride("Soft Landing"));
            llOwnerSay("Taking Off: " + llGetAnimationOverride("Taking Off"));
            llOwnerSay("Turning Left: " + llGetAnimationOverride("Turning Left"));
            llOwnerSay("Turning Right: " + llGetAnimationOverride("Turning Right"));
            llOwnerSay("Walking: " + llGetAnimationOverride("Walking"));
        }
    }
}
```

</details>

## History

Date of Release [12/04/2013](https://wiki.secondlife.com/wiki/Release_Notes/Second_Life_Server/13#13-04-12-273874)

## See also

### Functions

- [llSetAnimationOverride](/functions/llSetAnimationOverride/)
- [llResetAnimationOverride](/functions/llResetAnimationOverride/)

### Articles

- [Internal_Animations](https://wiki.secondlife.com/wiki/Internal_Animations) — lists internal Animations always available

---

*Source: [LlGetAnimationOverride](https://wiki.secondlife.com/wiki/LlGetAnimationOverride) on the Second Life Wiki. Content from the Second Life Wiki articles LlGetAnimationOverride (revision 1196969, 2015-07-15) and Template:LSL Function/permission (revision 1200093, 2016-05-12), CC BY-SA 3.0.*

---

From lsl.dev: https://lsl.dev/functions/llGetAnimationOverride/
