Перейти к содержимому
Mineforgian

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 Anti-XRay

Modrinth Downloads Hangar Downloads CurseForge Downloads

Dev Build CI Latest Version GitHub issues GitHub latest commit GPLv3 license

Support Version

Support Server

Image

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:

  1. 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.
  2. 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

Assessment 1

Assessment 2

Assessment 3

Assessment 4

Image

  • 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

Image

  • /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

Image

  • minertrack.bypass - Bypass X-Ray detection
  • minertrack.notify - Receive notifications and verbose information
  • minertrack.checkupdate - Receive update information and use /mtrack update
  • minertrack.use - Access the root command /mtrack
  • minertrack.check - Use /mtrack check
  • minertrack.kick - Use /mtrack kick
  • minertrack.logs - Use /mtrack logs
  • minertrack.help - Use /mtrack help
  • minertrack.reset - Use /mtrack reset
  • minertrack.sendnotify - Use /mtrack notify
  • minertrack.verbose - Use /mtrack verbose
  • minertrack.reload - Use /mtrack reload

Image

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

Image

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

Image

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

bStats


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

  • traceBackLength unit 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

  • traceBackLength unit 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~

Комментарии

Загружаем…