MineWatchAntiXray | Advanced Anti-Xray Plugin | 1.21.X icon

MineWatchAntiXray | Advanced Anti-Xray Plugin | 1.21.X -----

The most advanced detection plugin for identifying potential X-ray users.

Download Now
1.2 MB .jar


MineWatch AntiXray By NootherG

[​IMG] [​IMG] [​IMG]

Description

MineWatch AntiXray is a sophisticated Paper/Spigot plugin designed to detect suspicious ore mining behavior that commonly indicates X-ray usage. Unlike traditional detection methods, MineWatch uses contextual heuristics, intelligent scoring algorithms, and persistent tracking to provide accurate, actionable alerts to staff members.
Developed by: NootherG
Version: 0.1.2
API Version: 1.21+
Download Size: ~1.2MB

Read First
  1. The plugin is designed to work out-of-the-box, so fine tuning is more than likely not needed but the option to fine tune the plugin yourself exists
  2. The plugin does not automatically perform any punishments; it is instead designed to identify cheaters and provide the tools necessary to further build a staff member's case against them

Key Features
  1. Intelligent Detection System (elaborated on further down) - Context-aware analysis, ore-specific weighting, and streak monitoring to detect suspicious mining patterns
  2. Advanced GUI System - Inspect players visually with real-time suspicion data and breakdowns
  3. Smart Alert System - Two-tier alerts with clickable chat links and anti-spam throttling
  4. Persistent Storage - Saves data across restarts with autosaving and decay management
  5. Decoy System - Place fake ores to test suspicious players and automatically detect mining behavior (not automatic; this feature is designed fool cheaters while a staff member is observing)

Commands
  1. /antixray suspicion - View a player’s current suspicion score
  2. /antixray reset - Clear all suspicion data for a player
  3. /antixray inspect - Open the inspection GUI for a player
  4. /antixray history - View the player’s flag history GUI
  5. /antixray reload - Reload configuration and message files
  6. /antixray decoy [many options] - Place a decoy ore for a player
  7. /antixray decoy list - List all active decoys for a player
  8. /antixray decoy remove <id|all> - Remove decoy(s) for a player
  9. /antixray decoy info - View detailed information about a decoy
Aliases: /ax, /xray, /minewatch, /mw

Decoy Command Examples:
Code (Text):

/ax decoy diamond_ore PlayerName
/ax decoy auto PlayerName –at 100 50 200
/ax decoy list PlayerName
/ax decoy remove 5 PlayerName
/ax decoy remove all PlayerName
 
Permissions
  1. minewatch.antixray.command – Base command permission (default: OP)
  2. minewatch.antixray.command.suspicion – Use /antixray suspicion
  3. minewatch.antixray.command.reset – Use /antixray reset
  4. minewatch.antixray.command.inspect – Use /antixray inspect
  5. minewatch.antixray.command.history – Use /antixray history
  6. minewatch.antixray.command.decoy – Use /antixray decoy commands
  7. minewatch.antixray.notify – Receive FLAG and SEVERE alerts
LuckPerms Example:
Code (Text):

/lp group staff permission set minewatch.antixray.notify true
/lp group admin permission set minewatch.antixray.command.* true
 
Installation
  1. Download MineWatch-AntiXray-0.1.X.jar
  2. Place it in your server’s plugins/ folder
  3. Restart your server or use /reload
  4. Edit configuration or messages in plugins/MineWatchAntiXray/config.yml or messages.yml
  5. Grant permissions to your staff group
Requirements: Paper/Spigot 1.21+, Java 17+

Configuration
  1. All settings are fully configurable in config.yml
  2. Messages, thresholds, suspicion decay, and decoy options can all be customized
  3. GUI titles, alerts, and colors are editable in messages.yml

Detection System
  1. Block Placement Tracking - Prevents false positives from player-placed ores
  2. Exposure Analysis - Considers hidden faces, nearby caves, shell count, and cluster size
  3. Suspicion Scoring - Weighted by ore type, exposure, and streaks
  4. Decay System - Suspicion naturally decreases over time
  5. Alert System - FLAG and SEVERE alerts with clickable inspection links

GUI Features
  1. Inspection GUI - Shows suspicion scores, breakdowns, and last ore locations
  2. Flag History GUI - Displays last 28 flags or severe flags with color-coded levels
  3. Real-Time Updates - Data updates live as players mine

Decoy System
  1. Staff can place realistic fake ores that trigger detection when mined
  2. Decoys revert automatically on detection
  3. Per-player rate limits and time-to-live controls prevent abuse
  4. Supports multiple block decoys for realistic clusters

Tips & Best Practices
  1. Start with conservative detection settings and tune as needed (for the most part, this plugin is designed to work out-of-the-box; it has been fine tuned by developers already)
  2. Use the GUI to review suspicious players before acting
  3. Deploy decoys strategically rather than in bulk
  4. Reset suspicion only after confirming false positives
  5. Edit your messages.yml for server branding

Troubleshooting
Players not flagged?
  1. Check your thresholds – may be too high
  2. Ensure player is in survival/adventure mode
False positives?
  1. Lower multipliers or raise thresholds
  2. Ensure ore placement tracking is enabled
Decoys not working?
  1. Verify player online and valid coordinates
  2. Check decoy placement limits
Data not persisting?
  1. Ensure flush-on-disable is true
  2. Check file permissions
Alerts not showing?
  1. Give staff minewatch.antixray.notify
  2. Check console for errors (turn on debug in config.yml by ensuring that log-context is true)

Performance
  1. Memory: ~2–5MB per 100 tracked players
  2. CPU: Minimal – only triggers on ore breaks
  3. Disk: Async saves every 2 minutes (configurable)
  4. Network: None – fully server-side

Metrics

MineWatch AntiXray uses bStats to collect anonymous usage statistics (server version, Java version, player count, etc.). These metrics help guide development and are opt-in by default through plugins/bStats/config.yml on your server. These metrics greatly help me and have no affect on server performance, so if you could leave this on please do.

Support
  1. First - Check this post to make sure your issue has not already been addressed on the discussions page
  2. Issues or Questions - Report bugs using the discussions page on this resource
  3. Requesting Changes - Please also use the discussions page on this resource to request changes
  4. Updates - Check the resource page for the latest version

Credits
  1. Developer: NootherG
  2. API: Paper 1.21+
  3. Libraries: Caffeine (for caching)

License

This plugin is provided as-is. Use at your own risk.

Disclaimer: You do not have permission to decompile, edit, or redistribute this resource. You may request changes via discussion threads. This plugin is meant to be used as an aid to detect players using X-Ray and not as a definite punishment system; always review flags to confirm the accusations of cheating before punishing players.
View on SpigotMC
Resource Information
Author:
----------
Total Downloads: 128
First Release: Nov 5, 2025
Last Update: Today at 3:24 AM
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings