
MinerTrack Anti XRay
The Powerful Anti-Xray, help you auto catch X-rayers and punish them according to your configuration.
- Загрузки
- 79K
- Подписчики
- 124
- Обновлён
- 22 мая 2026 г.
- Лицензия
- GPL-3.0-only
Опубликован 9 ноября 2024 г.

MinerTrack Anti-XRay

MinerTrack is a plugin that will really help you catch those naughty players using Xray on your server in a different way from other Anti-Xray plugins. This plugin doesn't hide ores, as hiding ores requires a lot of resources.
So how does it work?
To catch Xray, MinerTrack uses an advanced algorithm that combines several factors like ore scarcity, the amount of ores mined in a certain period, the player’s path to ores, and many other aspects.
But can't people still use Xray?
Yes and no. Indeed, a player using Xray has two options:
- Keep using Xray but behave like a normal player to avoid being caught. They can't get more ores than a normal player or they’ll be caught by MinerTrack.
- Uninstall their Xray or be caught.
Why choose MinerTrack over other AntiXray options?
Compared to Paper Anti-XRay and Orebfuscator:
- MinerTrack is lightweight.
- MinerTrack's engine is innovative.
- MinerTrack detects Xray users, leaving it to you to decide on sanctions.
Compared to other AntiXray solutions:
- MinerTrack supports the latest Minecraft version.
- MinerTrack has been tested on servers with about 20 simultaneous players, with very few false positives (default config).
- MinerTrack is free.
Look what users have to say:
Assessments





- Detect XRayer
- Automatically handle cases when a player's X-Ray violation level reaches a threshold
- Automatically reduce the violation level when the player's behavior normalizes
- When the player is mining in a cave, they will not be detected incorrectly
- Highly configurable profiles

/mtrack notify <message>- Send alerts to staff/mtrack verbose- Enable Detailed Mode and notify staff with it enabled whenever a player’s violation level increases/mtrack check <player>- Check a player’s violation history/mtrack reset <player>- Reset a player's violation record/mtrack help- Get plugin help/mtrack kick <player> <reason>- Kick a player with a specific reason/mtrack reload- Reload the plugin’s configuration/mtrack update- Check for plugin updates/mtrack logs <log name.log>- View a MinerTrack log file

minertrack.bypass- Bypass X-Ray detectionminertrack.notify- Receive notifications and verbose informationminertrack.checkupdate- Receive update information and use/mtrack updateminertrack.use- Access the root command/mtrackminertrack.check- Use/mtrack checkminertrack.kick- Use/mtrack kickminertrack.logs- Use/mtrack logsminertrack.help- Use/mtrack helpminertrack.reset- Use/mtrack resetminertrack.sendnotify- Use/mtrack notifyminertrack.verbose- Use/mtrack verboseminertrack.reload- Use/mtrack reload

- Download the latest version of MinerTrack from Modrinth.
- Place the .jar file into the plugins folder.
- Restart the server to generate the configuration and necessary files.

- Java 17 or higher
- Paper, Purpur, Folia or compatible forks (1.18 or newer) Not Spigot!

If you encounter any issues or have suggestions for new features, feel free to reach out via Discord or open an issue on the plugin’s GitHub repository.
View Source: https://github.com/At87668/MinerTrack
Report Issue: https://github.com/At87668/MinerTrack/issues
Pull Requset: https://github.com/At87668/MinerTrack/pulls
Visit Wiki: https://minertrack.pages.dev/wiki/
Join Discord: https://discord.gg/MzTea2W9cb
If you want to support my work, you can subscribe my Patreon paid membership.
Or give the project a star on Github.
Ченджлог
1.10.1.1Релиз26.1.1, 26.1.2, 26.2 · 22 мая 2026 г.
1.10.1.1 - Path Handling Fix
Fixed BUG
- Path records are incorrectly cleared when players teleport.
Recommended to update.
Happy using~
1.10.1.0Релиз26.1, 26.1.1, 26.1.2 · 16 мая 2026 г.
1.10.1.0 - Detection Improve
Detection Improvement
- Add option to ignore artificial air.
Code Clear Up
- Completely removed the code related to
air monitor.
Configuration Item Changed
Before:
cave:
air-threshold: 14 # When the number of air blocks reaches several, the player is considered to be in a cave?
CaveAirMultiplier: 5 # If cave air is found, regarded as how many ordinary air?
detection-range: 3 # 3 = 7x7x7, 2 = 5x5x5
check_skip_vl: true # VL add of whether or not to skip natural behavior
# Prevents players from manually creating air to bypass detection.
air-monitor:
enable: true # Enable or disable
min-path-length: 10 # Minimum digging path required to perform this detection.
air-ratio-threshold: 0.3 # Air percentage threshold (e.g., 0.3 for 30%).
violation-increase: 1 # The value of the increase in rating after each triggered violation.
violation-threshold: 5 # The number of ratings reached should be flagged as suspicion of deliberate creation of artificial air.
remove-time: 20 # How long to remove this record once (in minutes)
Now:
cave:
air-threshold: 14 # When the number of air blocks reaches several, the player is considered to be in a cave?
CaveAirMultiplier: 5 # If cave air is found, regarded as how many ordinary air?
detection-range: 3 # 3 = 7x7x7, 2 = 5x5x5
check_skip_vl: true # VL add of whether or not to skip natural behavior
ignore-artificial-air: true # When true, ignore recently player-created air when checking for caves
artificial-air-remove-time: 20 # Minutes to consider broken blocks as artificial air
Recommend update to this version.
Recommend to rebuild the config.yml
Happy using~
1.10.0.3Релиз26.1, 26.1.1, 26.1.2 · 15 мая 2026 г.
1.10.0.3 - False Postive Fix
Fixed BUG
- Disabled stupid air monitor to remove the incorrectly added VL. [#12]
Happy using~
1.10.0.2Релиз26.1, 26.1.1, 26.1.2 · 2 мая 2026 г.
1.10.0.2 - Fix Folia air monitor path handling
Fixed BUG
- Folia air monitor path handling works incorrect. [#10] (fixed by xiaoyueyoqwq)
New Contributor
Happy using~
1.10.0.1Релиз26.1, 26.1.1, 26.1.2 · 14 марта 2026 г.
1.10.0.1 - Nether False Postive Hotfix
Fixed BUG
- When player using bed to got
Ancient Debris, false postive triggered after about ten minutes.
NOTE: This version changed the default parameter settings to prevent false positives, so if you are using default config, you need to manually modify the following items in nether.yml:
From
# Natural Detection
natural-detection:
enable: false
To
# Natural Detection
natural-detection:
enable: true
# Satisfying the conditions will think they are in a natural.
cave:
air-threshold: 14 # When the number of air blocks reaches several, the player is considered to be in a cave?
CaveAirMultiplier: 5 # If cave air is found, regarded as how many ordinary air?
detection-range: 3 # 3 = 7x7x7, 2 = 5x5x5
check_skip_vl: true # VL add of whether or not to skip natural behavior
# Prevents players from manually creating air to bypass detection.
air-monitor:
enable: true # Enable or disable
min-path-length: 10 # Minimum digging path required to perform this detection.
air-ratio-threshold: 0.3 # Air percentage threshold (e.g., 0.3 for 30%).
violation-increase: 1 # The value of the increase in rating after each triggered violation.
violation-threshold: 5 # The number of ratings reached should be flagged as suspicion of deliberate creation of artificial air.
remove-time: 20 # How long to remove this record once (in minutes)
Happy using~
1.10.0Релиз1.21.9, 1.21.10, 1.21.11 · 6 марта 2026 г.
1.10.0 - Better Configuration & Detection Improve
Stable version released!
New Features
Configure parameters by each world
- You can now efficiently configure detection parameters for each (or each group of) world.
# At what height should I start detecting X-Ray? # All worlds not explicitly listed will follow 'all_unnamed_world' # If 'all_unnamed_world' not listed, worlds that are not listed do not have XRay detection. # Configuration will be loaded from 'Configuration/file_name.yml' worlds: 'overworld': # It means overworld.yml - world - all_unnamed_world 'nether': - world_nether 'end': - world_the_end
Config Version Check
- When there are major changes to the configuration file, the original configuration file will be backed up and put upgraded configuration.
Detection Improve
- Improved the detect ability in multiple worlds.
Fixed BUG
traceBackLengthunit wrong.
Other Improvements
- Eliminated annoying compile warnings.
Added New Contributors
NOTE: After upgrading to this version, you need to re-add the configuration parameters to config.yml!
Happy using~
1.10.0-betaБета1.21.9, 1.21.10, 1.21.11 · 20 февраля 2026 г.
1.10.0-beta - Better Configuration & Detection Improve
The version on the Beta channel has already undergone initial testing. But this version is for early testing; please report any issues promptly.
New Features
Configure parameters by each world
- You can now efficiently configure detection parameters for each (or each group of) world.
# At what height should I start detecting X-Ray? # All worlds not explicitly listed will follow 'all_unnamed_world' # If 'all_unnamed_world' not listed, worlds that are not listed do not have XRay detection. # Configuration will be loaded from 'Configuration/file_name.yml' worlds: 'overworld': # It means overworld.yml - world - all_unnamed_world 'nether': - world_nether 'end': - world_the_end
Config Version Check
- When there are major changes to the configuration file, the original configuration file will be backed up and put upgraded configuration.
Detection Improve
- Improved the detect ability in multiple worlds.
Fixed BUG
traceBackLengthunit wrong.
Other Improvements
- Eliminated annoying compile warnings.
NOTE: After upgrading to this version, you need to re-add the configuration parameters to config.yml!
Happy using~
1.9.0.3Релиз1.21.9, 1.21.10, 1.21.11 · 10 января 2026 г.
1.9.0.3 - More WebHook Placeholders
Added Placeholders
%world%- Indicates the world the player is in.%timestamp%- Timestamp of the message.
Happy using~
Комментарии
Загружаем…