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

# Pet State Action

# Pet State Action

**Type:** `pets_state`

Modifies the state of a specific pet for the player.

## Configuration

| Field    | Type                | Default  | Description                |
| :------- | :------------------ | :------- | :------------------------- |
| `id`     | String              | ""       | Unique identifier.         |
| `pet`    | Ref\<PetDefinition> | Empty    | The pet species to affect. |
| `action` | Enum                | ACTIVATE | Action to perform.         |

## Actions

| Action       | Description                                            |
| :----------- | :----------------------------------------------------- |
| `ACTIVATE`   | Spawn the pet and make it the active companion.        |
| `DEACTIVATE` | Despawn the pet if it is currently active.             |
| `HIDE`       | Hide the pet (despawn visuals but keep active status). |
| `SHOW`       | Show the pet (spawn visuals if active).                |
| `REMOVE`     | Remove the pet from the player's collection entirely.  |