> For the complete documentation index, see [llms.txt](https://wiki.chrisgraph.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.chrisgraph.fr/how-to-install/xray-detectors.md).

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