XrayDetect
Advanced Xray Detection & Mining Analytics for Spigot/Paper

A powerful monitoring system that analyzes player mining behavior and detects suspicious xray-like patterns in real time.

Why XrayDetect?
Most anti-xray systems only hide ores, but do not help you identify cheaters.
XrayDetect focuses on detection and monitoring, giving you detailed mining statistics and actionable alerts to catch xray users efficiently.

Works perfectly alongside Paper Anti-Xray or as a standalone monitoring tool on Spigot.

✨ Features
Paper Anti-Xray Integration (Optional)

• Designed to work alongside Paper's built-in Anti-Xray system
  
  
• Includes setup instructions for paper-world-defaults.yml
  
  
• Paper handles ore obfuscation, XrayDetect handles detection

Intelligent Mining Statistics

• Real-time tracking of mining patterns for all players
  
  
• Supported ores:
  Diamond, Emerald, Gold, Iron, Redstone, Lapis, Copper, Ancient Debris, Quartz
  
  
• Realistic default alert thresholds:
  • Diamond: 2.5%
    
    
  • Emerald: 1.5%
    
    
  • Ancient Debris: 1.0%
    
    
  • Gold: 4.0%
    
    
  • Copper: 30.0%
    
    
  • Iron: 25.0%
    
    
  • Redstone: 12.0%
    
    
  • Lapis: 8.0%
    
    
  • Quartz: 15.0%
• Minimum mined blocks requirement (default: 300) to avoid false positives

Smart Suspicious Detection

• Automatically flags players exceeding ore thresholds
  
  
• Anti-spam cooldown system (default: 30 minutes) to prevent duplicate alerts
  
  
• Real-time admin alerts with detailed info
  
  
• Stores suspicious entries with timestamps and coordinates

Admin Moderation Tools

• Unified command system: /xd, /xray, /xraydetect
  
  
• View detailed player stats with warning highlights
  
  
• Teleport to suspicious players or detection coordinates
  
  
• Punish / ignore system with full audit logs
  
  
• Clickable chat buttons for fast moderation actions
  
  
• Optional ban suggestions after punishment

Commands
Command Description
/xd help Show help menu
/xd status Plugin status & statistics
/xd stats <player> Detailed player mining statistics
/xd sus [page] Suspicious players list
/xd punish <id> <reason> Mark and punish suspicious player
/xd ignore <id> Ignore suspicious entry
/xd reload Reload configuration
Permissions
Permission Description Default
xraydetect.admin Full access OP
xraydetect.use Basic access OP
⚙️ Configuration Example
statistics:
enabled: true
minimum-blocks-threshold: 300
alert-thresholds:
DIAMOND: 2.5
EMERALD: 1.5
GOLD: 4.0

suspicious:
auto-expire-time: 30
re-flag-cooldown: 30
max-entries: 1000

worlds:
statistics-blacklist:
- creative_world
- build_world

️ Interactive Admin Features
Clickable Chat Actions

• [TP] Teleport to player or detection location
  
  
• [PUNISH] Quick punish suggestion
  
  
• [IGNORE] Dismiss report
  
  
• Pagination buttons for browsing suspicious list

Real-Time Alerts
Admins receive instant notifications including:

• Player name
  
  
• Ore type & mined percentage
  
  
• Threshold comparison
  
  
• World and coordinates

How It Works

1. Player mines blocks → stats recorded
   
   
2. After minimum blocks threshold → algorithm checks ore ratios
   
   
3. Threshold exceeded → suspicious entry created
   
   
4. Cooldown prevents spam alerts
   
   
5. Admin investigates with /xd stats
   
   
6. Take action (punish / ignore)

Logging System

• Detailed logs stored in logs/activity.log
  
  
• Tracks detections, punishments, and admin actions
  
  
• Includes timestamps, UUIDs, and coordinates

Compatibility
Software Status
Paper 1.21+ Fully Supported (recommended)
Spigot 1.21+ Supported
Folia Not Supported
Java 21+ required

⚡ Performance

• Lightweight & low CPU usage
  
  
• Async statistics processing
  
  
• Scales to large servers
  
  
• No heavy tick loops

⭐ Why XrayDetect?
✔ Easy setup
✔ Realistic thresholds (low false positives)
✔ Admin-friendly interface
✔ Works with Paper Anti-Xray
✔ Anti-spam detection system
✔ Actively developed

Catch x-rayers without manual log checking.

Made with ❤️ for the Minecraft community