---

✨ Key Features

🔒 Paper Integration

• Works alongside Paper's built-in anti-xray for comprehensive protection
• Plugin includes clear instructions for configuring Paper's anti-xray in paper-world-defaults.yml
• Focuses on detection and monitoring while Paper handles ore obfuscation

📊 Intelligent Mining Statistics

• Tracks ore mining patterns for all players in real-time
• Monitors multiple ore types: Diamond, Emerald, Gold, Iron, Redstone, Lapis, Copper, Ancient Debris, and Quartz
• Individual alert thresholds for each ore type with realistic percentages:
  • 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 blocks threshold (default: 300 blocks) before triggering alerts
• Prevents false positives for new players

🚨 Smart Suspicious Detection

• Automatic flagging when players exceed ore-specific thresholds
• Anti-spam cooldown system - prevents duplicate reports for already flagged players (default: 30 min cooldown)
• Real-time alerts sent to admins with permission
• Detailed suspicious player tracking with timestamps and locations

👮 Administrative Tools

• Unified /xd command structure for all plugin functions
• View player statistics with color-coded warnings
• Teleport to suspicious players (online) or their detection coordinates (offline)
• Punish or ignore flagged players with full audit logging
• Interactive clickable buttons for quick actions
• Ban suggestions after punishment

---

🎮 Commands

All commands use the unified /xd, /xray or /xraydetect prefix:

Command	Description
/xd help	Display comprehensive help menu
/xd status	View plugin status and statistics
/xd stats <player>	View detailed mining statistics for a player
/xd sus [page]	Browse suspicious players list with pagination
/xd punish <id> <reason>	Punish a suspicious player with reason
/xd ignore <id>	Ignore a suspicious player entry
/xd reload	Reload plugin configuration

---

🔑 Permissions

Permission	Description	Default
xraydetect.admin	Access to all plugin commands	OP
xraydetect.use	Basic plugin usage	OP

---

⚙️ Configuration Highlights

# Statistics Tracking
statistics:
  enabled: true
  minimum-blocks-threshold: 300
  alert-thresholds:
    DIAMOND: 2.5
    EMERALD: 1.5
    # ... individual thresholds for each ore

# Suspicious Detection
suspicious:
  auto-expire-time: 30  # minutes
  re-flag-cooldown: 30  # prevents duplicate reports
  max-entries: 1000

# World Blacklists
worlds:
  statistics-blacklist:
    - creative_world
    - build_world

---

📱 Interactive Features

Click-to-Action Buttons

• [TP] - Teleport to flagged player's current location (or detection coordinates)
• [PUNISH] - Quick-punish with auto-suggested command
• [IGNORE] - Instantly ignore a report
• Pagination - Navigate through suspicious players list

Real-Time Alerts

Admins receive instant notifications when suspicious mining patterns are detected, including:

• Player name
• Ore type and percentage
• Threshold comparison
• Detection location

---

🎯 How It Works

1. Player mines ores → Statistics are recorded
2. After 300+ blocks mined → Algorithm checks percentages
3. If threshold exceeded → Admin alert is triggered
4. Cooldown activates → Prevents spam for 30 minutes
5. Admins investigate → Use /xd stats <player> and /xd sus
6. Take action → Punish or ignore with full logging

---

💾 Logging System

• Comprehensive activity logging to logs/activity.log
• Tracks all detections, punishments, and admin actions
• Includes timestamps, player UUIDs, and coordinates
• Useful for reviewing historical data

---

🔄 Compatibility

• Server Software: Paper 1.21+ (recommended), Spigot 1.21+
• Java Version: Java 21+
• Dependencies: None - works out of the box!

---

📈 Performance

• Lightweight: Minimal CPU and RAM usage
• Scalable: Handles hundreds of concurrent players
• Async operations: Statistics tracking won't lag your server

---

⭐ Why Choose XrayDetect?

✅ Easy Setup - Install and go, minimal configuration required
✅ Smart Detection - Realistic thresholds prevent false positives
✅ Admin Friendly - Intuitive commands and interactive interface
✅ Performance First - Uses Paper's optimized engine
✅ No False Spam - Cooldown system prevents duplicate reports
✅ Active Development - Regular updates and improvements

Protect your server from x-rayers without the hassle! 🛡️

• Support:
• on Discord Server

---