CraftShaft XRay Detector 1.4

Automatically detect if players are using x-ray

  1. AmirShabani
    Native Minecraft Version:
    Tested Minecraft Versions:
    • 1.12
    • 1.13
    Source Code:
    CraftShaft X-Ray

    Source code on Github:

    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. Thank you!

    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
    • - /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,, 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:
    Minecraft server running CraftShaft X-Ray:
    xSudden_ likes this.

Recent Reviews

  1. FOGos
    Version: 1.2
    good idea, good plugin, thanks to the developer! Fat like for trying!!!!!!!!!!!!!
    1. AmirShabani
      Author's Response
      Thank you! :)
  2. FlailoftheLord
    Version: 1.2
    A better idea instead of adding blocks manually, create a list in the config where the server admin can add which blocks he wants to be checked.
    1. AmirShabani
      Author's Response
      Will be added in 1.3 :)
  3. Orange_Juice20
    Version: 2019-03-22
    Amazing stuff here :) Catching all the x rayers on my server trying to ruin the fun!
    1. AmirShabani
      Author's Response
      Glad you're enjoying it!