> ## 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.

# Attribute Actions

> Control player stats including health, speed, damage, and physics properties.

Attribute actions provide direct control over a player's physical and combat capabilities. These actions modify standard Minecraft attributes, allowing for RPG-like progression (e.g., "Speed Up" skills) or temporary buffs.

<Info>
  **Mechanic:** These actions typically **add** or **set** a base value depending on the implementation. Most are designed to be used with a `duration` for temporary buffs.
</Info>

## Available Attributes

| Action ID                   | Attribute         | Description                                   |
| :-------------------------- | :---------------- | :-------------------------------------------- |
| `attack_damage_action`      | **Attack Damage** | Base melee damage dealt.                      |
| `attack_speed_action`       | **Attack Speed**  | Cooldown recovery speed for attacks.          |
| `attack_knockback_action`   | **Knockback**     | Force applied to enemies on hit.              |
| `movement_speed_action`     | **Walk Speed**    | Standard ground movement speed.               |
| `fly_speed_action`          | **Fly Speed**     | Creative/Spectator flight speed.              |
| `gravity_action`            | **Gravity**       | Vertical pull strength.                       |
| `scale_action`              | **Model Scale**   | Player size (requires client support/Pehkui). |
| `health_action`             | **Max Health**    | Maximum HP pool.                              |
| `safe_fall_distance_action` | **Safe Fall**     | Block distance before taking fall damage.     |
| `block_reach_action`        | **Reach**         | Distance to mine/place blocks.                |
| `block_break_speed_action`  | **Mining Speed**  | Speed of breaking blocks.                     |

<Accordion title="See All Attributes">
  | Action ID                        | Attribute            | Description                                    |
  | :------------------------------- | :------------------- | :--------------------------------------------- |
  | `sneaking_speed_action`          | **Sneak Speed**      | Speed while crouching.                         |
  | `step_height_action`             | **Step Height**      | Height of blocks player can walk up instantly. |
  | `knockback_resistance_action`    | **KB Resist**        | Chance to ignore knockback.                    |
  | `explosion_kb_resistance_action` | **Explosion Resist** | Resistance to blast knockback.                 |
  | `max_absorption_action`          | **Absorption**       | Max golden-heart absorption.                   |
  | `luck_action`                    | **Luck**             | Loot table luck modifier.                      |
  | `bonus_armor_action`             | **Armor**            | Native armor points.                           |
  | `burning_time_action`            | **Burn Time**        | Duration of fire ticks.                        |
  | `fall_damage_multiplier_action`  | **Fall Dmg Mult**    | Multiplier for fall damage calculation.        |
  | `water_movement_action`          | **Swim Speed**       | Speed while in water.                          |
  | `submerged_mining_action`        | **Aqua Mining**      | Mining speed while underwater.                 |
  | `oxygen_bonus_action`            | **Lung Capacity**    | Underwater breath time.                        |
  | `camera_distance_action`         | **Camera Dist**      | 3rd person camera boom length.                 |
</Accordion>

## Configuration

<ResponseField name="value" type="Var<Double>" required>
  The magnitude of the change.

  *Example: `0.1` might represent +10% speed depending on the base.*
</ResponseField>

<ResponseField name="duration" type="Var<Duration>">
  Time before the attribute reverts to normal. Supports `s` (seconds), `m` (minutes), `h` (hours).

  *Defaults to **instant/permanent** if not specified.*
</ResponseField>

## Example Usage

<CodeGroup>
  ```yaml Speed Buff theme={null}
  # Increases movement speed by 50% for 30 seconds
  movement_speed_action:
    value: 0.15
    duration: "30s"
  ```

  ```yaml Giant Strength theme={null}
  # Increases size and damage permanently
  scale_action:
    value: 2.0
  attack_damage_action:
    value: 10.0
  ```
</CodeGroup>