> For the complete documentation index, see [llms.txt](https://wiki.staffplusplus.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.staffplusplus.org/features/alerts/x-ray.md).

# X-Ray

The x-ray is used to notify staff members when players mine a certain block. The alerts can be configured to run after a specific threshold has been reached.

```yaml
xray-alerts:
    # Whether or not this module is enabled.
    enabled: true

    # Block type that, when mined, will invoke an alert.
    blocks: SPAWNER, EMERALD_ORE:10, DIAMOND_ORE:10:1m, GOLD_ORE, IRON_ORE, COAL_ORE, LAPIS_ORE, REDSTONE_ORE
```

Blocks can be configured in three different ways.

#### Trigger every time \[blocktype]

Example: `SPAWNER` \
The above configuration will trigger an alert every time a player mines a spawner.

#### Trigger after amount \[blocktype:amount]

Example: `EMERALD_ORE:10` \
The above configuration will trigger an alert every time a player mines a total of 10 emeralds.

#### Trigger after amount/time \[blocktype:amount:time]

Example: `DIAMOND_ORE:10:1m` \
The above configuration will trigger an alert whenever a player mines 10 diamond block within the time span of 1 minute.

**Possible time values:**

* s = second
* m = minute
* h = hour
* d = day
* w = week
* M = month
* y = year

*Time values cannot be combined. For example this is invalid: "1m30s" instead type "90s"*