# xRay Detectors

:thumbsup: **Download this plugin on** [**BuiltByBit**](https://builtbybit.com/members/chris-graph.151148/)

### ✅ Features

* **Suspicion score** per player (sliding window, 10 min).
* **Multi‑signal analysis**: mining speed, movement patterns, rare ratio, ore targeting.
* **Cave filter**: if the player is mining in open caves (air exposure + high speed), the score is suppressed → major false‑positive reduction.
* **Moderator GUI**: suspects list, per‑player details, teleport, reset.
* **Staff alerts** (configurable cooldown).
* **Separate logs**:
  * summary.yml = only when an admin runs /xray summary
  * autologs.yml = automatic detections
* **Clean config** with commented “medium” values.

### ⚙️ How it works

The plugin samples player positions every 1s (only active players).\
Score is computed from four categories:

1. **Mining speed**
   * blocks/minute + long streaks
2. **Movement**
   * direction change average + vertical distance ratio
   * average speed used to separate caves vs walls
3. **Rare ratio**
   * rare/common ratio + Y‑band baseline z‑score
   * raw‑ratio fallback before baseline is ready
4. **Ore targeting**

* repeated pattern “dig common → reach rare”

This is **probabilistic scoring**, not proof.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.chrisgraph.fr/how-to-install/xray-detectors.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.