XrayDetector

A Minecraft X-ray Detection Plugin

XrayDetector is a comprehensive detection system for identifying potential X-ray usage on Minecraft servers. This plugin monitors ore mining patterns and alerts staff members when suspicious activity is detected.

Author: nevmind
Version: 1.0.0
All Rights Reserved

Features

Core Detection System

• Pattern-Based Detection: Monitors ore mining frequency and speed to identify suspicious patterns
• Four-Tier Severity System: Classifies alerts as Low, Medium, High, or Very High based on mining behavior
• Points Tracking: Maintains cumulative X-ray suspicion scores for each player
• Real-Time Alerts: Notifies staff members instantly when detection thresholds are met

Comprehensive Commands

• /xray toggle - Enable or disable the detection system
• /xray set ores <number> - Configure ore threshold for alerts
• /xray set time <seconds> - Set the time window for detection
• /xray tp <player> - Teleport to suspected player in spectator mode (invisible)
• /xray chances list - View top 10 players with highest X-ray suspicion points
• /xray reload - Reload configuration without restarting

Advanced Configuration

• Customizable Thresholds: Adjust ore counts and time windows
• Severity Levels: Configure point values for each severity tier
• Alert Colors: Customize message colors using Minecraft color codes
• Toggle System: Enable/disable detection without removing the plugin

Permission System

• xray.admin - Access to all plugin commands (default: op)
• xray.alerts - Receive X-ray detection alerts (default: op)

Installation

1. Download XrayDetector-1.0.0.jar from the releases
2. Place the JAR file in your server's plugins folder
3. Restart your server or use a plugin manager to load it
4. Configure the plugin in plugins/XrayDetector/config.yml

Compatibility

Supported Platforms

• Paper (Recommended)
• Spigot
• Bukkit
• PurPur
• Pufferfish

Minecraft Versions

• 1.21.x (Latest)
• 1.20.x
• 1.19.x
• 1.18.x
• 1.17.x
• 1.16.x
• 1.15.x
• 1.14.x
• 1.13+ (Minimum)

The plugin uses the Bukkit API 1.13+ for maximum compatibility across versions.

Configuration

The plugin creates a config.yml file in plugins/XrayDetector/ with the following options:

Basic Settings

# Enable or disable detection system
enabled: true

# Number of ores to trigger alert
ores_threshold: 10

# Time window in seconds
time_window: 60

Severity Levels

Each severity level can be configured with minimum/maximum ore counts and point values:

• Low: 5-10 ores (5 points)
• Medium: 11-20 ores (15 points)
• High: 21-35 ores (30 points)
• Very High: 36+ ores (50 points)

Alert Colors

Customize alert message colors using Minecraft color codes:

• &b = Aqua (Light Blue)
• &f = White
• &e = Yellow
• &6 = Gold
• &c = Red
• &4 = Dark Red

How It Works

Detection Logic

1. Monitoring: The plugin tracks when players mine ore blocks
2. Pattern Analysis: Calculates mining speed (ores per second) within the time window
3. Severity Assessment: Determines alert level based on ore count and mining speed
4. Point Assignment: Adds points to the player's X-ray suspicion score
5. Staff Notification: Sends formatted alerts to all staff with xray.alerts permission

Tracked Ores

The plugin monitors all ore types including:

• Coal, Iron, Gold, Diamond, Emerald
• Lapis Lazuli, Redstone, Copper
• Nether Gold, Nether Quartz
• Ancient Debris
• Deepslate variants of all ores

Alert Format

[XrayDetector] PlayerName mined 15 ores in 30.0 seconds [MEDIUM] (+15 points, Total: 45)

Commands & Permissions

Aliases: /xr, /xraydetector

FAQ

Q: Does this plugin prevent X-ray?
A: No, this plugin only detects potential X-ray usage. It cannot prevent players from using X-ray texture packs or mods.

Q: Will this catch all X-ray users?
A: The plugin detects suspicious mining patterns that may indicate X-ray usage. However, it's not 100% accurate and should be used as one tool among many for server moderation.

Q: Can players see the alerts?
A: Only players with the xray.alerts permission (typically staff) receive alerts.

Q: What happens when a player is detected?
A: The plugin only sends alerts and tracks points. Staff must manually review and take appropriate action.

Q: Does this work on older versions?
A: The plugin requires Minecraft 1.13 or newer due to API compatibility.

Support & Updates

For bug reports, feature requests, or support:

• Open an issue on the project repository
• Contact the server administrator

License

XrayDetector by nevmind
All Rights Reserved

This software is proprietary and confidential. Unauthorized copying, distribution, or modification is strictly prohibited without explicit permission from the author.

Credits

Developer: nevmind
Plugin Version: 1.0.0
Last Updated: 2025

Thank you for using XrayDetector!