👀xRay Detectors

Monitor your players with a plugin that interprets if the player is suspected of using XRay.

👍 Download this plugin on BuiltByBit

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