🛡️ XrayDetect

Advanced xray detection and monitoring system for Paper/Spigot servers

XrayDetect is a comprehensive plugin that monitors player mining statistics and detects suspicious behavior patterns to help server administrators catch xray users effectively.

✨ 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

Player mines ores → Statistics are recorded
After 300+ blocks mined → Algorithm checks percentages
If threshold exceeded → Admin alert is triggered
Cooldown activates → Prevents spam for 30 minutes
Admins investigate → Use /xd stats <player> and /xd sus
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: we_rt on discord, only if you are 100% something is broken

Made with ❤️ for the Minecraft community

Xray Detect