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

# Status Actions

> Apply status effects, manage health, and special states.

Control the player's metabolism, status conditions, and meta-data.

## Configuration

<Accordion title="Vitals & Metabolism">
  ### `set_hunger_action`

  <ResponseField name="level" type="Int" default="20">Food level (0-20).</ResponseField>

  ### `set_saturation_action`

  <ResponseField name="amount" type="Float" default="5.0">Saturation points.</ResponseField>

  ### `set_absorption_action`

  <ResponseField name="amount" type="Double" default="0.0">Golden hearts amount.</ResponseField>

  ### `set_air_action`

  <ResponseField name="ticks" type="Int" default="300">Remaining breath ticks underwater.</ResponseField>
</Accordion>

<Accordion title="Status Conditions">
  ### `set_fire_action`

  <ResponseField name="ticks" type="Int" default="0">Ticks to burn.</ResponseField>

  ### `freeze_action`

  <ResponseField name="ticks" type="Int" default="0">Ticks to freeze (powder snow effect).</ResponseField>
</Accordion>

<Accordion title="Meta States">
  ### `grant_advancement_action`

  <ResponseField name="key" type="NamespacedKey">e.g., `minecraft:story/mine_stone`</ResponseField>

  ### `set_compass_target_action`

  <ResponseField name="location" type="Location">Target XYZ.</ResponseField>
</Accordion>

## Example Usage

<CodeGroup>
  ```yaml Full Heal theme={null}
  set_hunger_action:
    level: 20
  set_saturation_action:
    amount: 20.0
  ```

  ```yaml Freeze theme={null}
  freeze_action:
    ticks: 140 # 7 seconds
  ```
</CodeGroup>