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

# Detection Activities

> Sensory-based detection activities for Hearing, Smell, Equipment, and Health.

In addition to vision, the Vanilla extension provides several sensory-based detection activities. These activities proactive scan for nearby players based on specific conditions and trigger actions.

## Common Features

All detection activities support the following:

* **One-Time Trigger:** Actions are executed once when a player is first detected. The action will only trigger again if the player leaves the detection range and then returns.
* **Criteria:** Filter which players can be detected.

***

## Hearing Activity

Detects players who are moving or making noise nearby.

**Entry ID:** `hearing_activity`

| Field      | Type                          | Default | Description                    |
| :--------- | :---------------------------- | :------ | :----------------------------- |
| `radius`   | `Double`                      | `10.0`  | Hearing range.                 |
| `triggers` | `List<Ref<TriggerableEntry>>` | `[]`    | Actions to trigger when heard. |
| `criteria` | `List<Criteria>`              | `[]`    | Conditions for detection.      |

***

## Smell Activity

Detects players within a certain radius.

**Entry ID:** `smell_activity`

| Field      | Type                          | Default | Description                      |
| :--------- | :---------------------------- | :------ | :------------------------------- |
| `radius`   | `Double`                      | `10.0`  | Smell range.                     |
| `triggers` | `List<Ref<TriggerableEntry>>` | `[]`    | Actions to trigger when smelled. |
| `criteria` | `List<Criteria>`              | `[]`    | Conditions for detection.        |

***

## Equipment Detection Activity

Detects players wearing specific armor or holding specific items.

**Entry ID:** `equipment_detection_activity`

| Field      | Type                          | Default           | Description                       |
| :--------- | :---------------------------- | :---------------- | :-------------------------------- |
| `material` | `Material`                    | `IRON_CHESTPLATE` | Material to detect.               |
| `radius`   | `Double`                      | `10.0`            | Detection range.                  |
| `triggers` | `List<Ref<TriggerableEntry>>` | `[]`              | Actions to trigger when detected. |
| `criteria` | `List<Criteria>`              | `[]`              | Conditions for detection.         |

***

## Health Detection Activity

Detects players with health below a certain threshold.

**Entry ID:** `health_detection_activity`

| Field       | Type                          | Default | Description                        |
| :---------- | :---------------------------- | :------ | :--------------------------------- |
| `threshold` | `Double`                      | `10.0`  | Health threshold (in half-hearts). |
| `radius`    | `Double`                      | `10.0`  | Detection range.                   |
| `triggers`  | `List<Ref<TriggerableEntry>>` | `[]`    | Actions to trigger when detected.  |
| `criteria`  | `List<Criteria>`              | `[]`    | Conditions for detection.          |

***

## Invisible Player Detection Activity

Detects invisible players who are holding a revealing item.

**Entry ID:** `invisible_player_detection_activity`

| Field             | Type                          | Default        | Description                               |
| :---------------- | :---------------------------- | :------------- | :---------------------------------------- |
| `material`        | `Material`                    | `GLOW_BERRIES` | Item the player must hold to be detected. |
| `radius`          | `Double`                      | `10.0`         | Detection range.                          |
| `detectionRadius` | `Double`                      | `30.0`         | Origin return radius.                     |
| `triggers`        | `List<Ref<TriggerableEntry>>` | `[]`           | Actions to trigger when detected.         |
| `criteria`        | `List<Criteria>`              | `[]`           | Conditions for detection.                 |