Xray Detect

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2

平台： paper purpur spigot

标签： management social utility

✨ 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:

? Permissions

⚙️ 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