> ## Documentation Index
> Fetch the complete documentation index at: https://docs.borntocraftstudio.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Player Limb Definition

> A BetterModel player limb entity for player animations.

The **Player Limb Definition** creates a fake entity that is attached to a player using KrToxicity's BetterModel limb system. It is useful for creating animated player models or cosmetic additions.

## Properties

| Property                   | Type         | Default | Description                                                              |
| :------------------------- | :----------- | :------ | :----------------------------------------------------------------------- |
| `id`                       | String       |         | The unique identifier for this entry.                                    |
| `name`                     | String       |         | The internal name of the entry.                                          |
| `limbId`                   | Var\<String> | `""`    | The BetterModel limb ID to use (from the `limbs` folder in BetterModel). |
| `defaultAnimationSettings` | Object       |         | Default animation settings for the player limb.                          |
| `focusOffset`              | Vector       | `0,0,0` | Offset used as the focus point for interaction bounds.                   |

### Default Animation Settings

| Property        | Type         | Default | Description                                                        |
| :-------------- | :----------- | :------ | :----------------------------------------------------------------- |
| `idle`          | Var\<String> | `idle`  | The animation to play when the entity is idle.                     |
| `walk`          | Var\<String> | `walk`  | The animation to play when the entity is moving.                   |
| `walkAnimation` | Boolean      | `true`  | Whether to automatically switch to the walk animation when moving. |

## Example

```yaml theme={null}
bettermodel_playerlimb_definition:
  id: "my_player_limb"
  limbId: "custom_limb"
  focusOffset:
    y: 1.0
  defaultAnimationSettings:
    idle: "stand"
    walk: "run"
```