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

Command	Permission	Description
/xray toggle	xray.admin	Toggle detection on/off
/xray set ores <num>	xray.admin	Set ore threshold
/xray set time <sec>	xray.admin	Set time window
/xray tp <player>	xray.admin	Teleport to player (spectator)
/xray chances list	xray.admin	Show top suspects
/xray reload	xray.admin	Reload configuration

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!