XrayDetector
A lightweight plugin that sends alerts to the staff team when it suspects that someone is X-raying
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
- Download
XrayDetector-1.0.0.jarfrom the releases - Place the JAR file in your server's
pluginsfolder - Restart your server or use a plugin manager to load it
- 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
- Monitoring: The plugin tracks when players mine ore blocks
- Pattern Analysis: Calculates mining speed (ores per second) within the time window
- Severity Assessment: Determines alert level based on ore count and mining speed
- Point Assignment: Adds points to the player's X-ray suspicion score
- Staff Notification: Sends formatted alerts to all staff with
xray.alertspermission
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!
