Automatic X-Ray Detector

CraftShaft X-Ray

Source code on Github: https://github.com/ShabaniAmir/CraftShaftXray

Spigot Version: 1.13.2

Not tested with other versions. If you'd like this plugin for another version, contact me.

I struggled with finding a proper x-ray detecting plugin for 1.13.2, so I decided to develop one.

If this plugin works for you, please consider leaving a review.

Please note: I am a software developer, but this is my first project with BukkitCraft plugins. If any functionality is missing, or there are any bugs, please contact me through my discord server (link at the bottom)

How it works

Every time a player breaks a stone block or a diamond ore, CraftShaft X-Ray records it. It then calculates the ratio of diamonds to stone mined. (EDIT: In the 1.5 version, which will be uploaded soon, CraftShaft XRay can be configured to monitor for more ores than just diamond). I spent some time with a hacked client x-raying and mining diamonds, and found the ratio of hackers is most often between 0.8 to 0.15. The default configuration is 0.8, you can change this with the /csxsetratio command-- bring it higher if you're getting a lot of false positives, or lower if hackers are slipping by.

CraftShaft X-Ray automatically deletes it's records of players once they leave the game. It's very efficient and has low impact on servers. It was tested on a local server of a "not-so-good" laptop and it faired well.

How to Install

Simply drag and drop CraftShaftXRay.jar in your plugins folder and restart the server.

This plugin has no dependencies.

Permissions & Commands

craftshaft.xray.alert - Players with this permission receive an alert when a player is suspected of x-raying
craftshaft.xray.bypass - Players with this permission will not be monitored
craftshaft.xray.top - /csxtop - Get the top 5 highest x-ray ratios of online players
craftshaft.xray.ratio - /csxratio <player> - Get diamond to stone ratio of online player
craftshaft.xray.setratio - /csxsetratio [ratio] - Get or change the threshold ratio

The way I have the permissions set up on my server is:

Any staff (Moderators, Admin, etc) that have the power to ban/tempban a player for hacking has the craftshaft.xray.alert, craftshaft.xray.top, and craftshaft.xray.ratio permission.

All staff have the craftshaft.xray.bypass permission. This way if the plugin doesn't bother monitoring their activities.

Only owners or those who understand how this plugin works should have access to craftshaft.xray.setratio

Questions? Suggestions? Let's talk

This plugin was original developed for The Craft Shaft server, and it will be running on there if you want to take a look.

I can be reached on my discord server: https://discord.gg/YvBFZJx

Minecraft server running CraftShaft X-Ray: mc.thecraftshaft.net:25599