# XrayDetector<\/p>\n
**A Minecraft X-ray Detection Plugin**<\/p>\n
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.<\/p>\n
**Author:** nevmind
\n**Version:** 1.0.0
\n**All Rights Reserved**<\/p>\n
—<\/p>\n
## Features<\/p>\n
### Core Detection System
\n– **Pattern-Based Detection**: Monitors ore mining frequency and speed to identify suspicious patterns
\n– **Four-Tier Severity System**: Classifies alerts as Low, Medium, High, or Very High based on mining behavior
\n– **Points Tracking**: Maintains cumulative X-ray suspicion scores for each player
\n– **Real-Time Alerts**: Notifies staff members instantly when detection thresholds are met<\/p>\n
### Comprehensive Commands ### Advanced Configuration ### Permission System —<\/p>\n ## Installation<\/p>\n 1. Download `XrayDetector-1.0.0.jar` from the releases —<\/p>\n ## Compatibility<\/p>\n ### Supported Platforms ### Minecraft Versions The plugin uses the Bukkit API 1.13+ for maximum compatibility across versions.<\/p>\n —<\/p>\n ## Configuration<\/p>\n The plugin creates a `config.yml` file in `plugins\/XrayDetector\/` with the following options:<\/p>\n ### Basic Settings # Number of ores to trigger alert # Time window in seconds ### Severity Levels ### Alert Colors —<\/p>\n ## How It Works<\/p>\n ### Detection Logic ### Tracked Ores ### Alert Format —<\/p>\n ## Commands & Permissions<\/p>\n | Command | Permission | Description | **Aliases:** `\/xr`, `\/xraydetector`<\/p>\n —<\/p>\n ## FAQ<\/p>\n **Q: Does this plugin prevent X-ray?** **Q: Will this catch all X-ray users?** **Q: Can players see the alerts?** **Q: What happens when a player is detected?** **Q: Does this work on older versions?** —<\/p>\n ## Support & Updates<\/p>\n For bug reports, feature requests, or support: —<\/p>\n ## License<\/p>\n **XrayDetector** by **nevmind** This software is proprietary and confidential. Unauthorized copying, distribution, or modification is strictly prohibited without explicit permission from the author.<\/p>\n —<\/p>\n ## Credits<\/p>\n **Developer:** nevmind Thank you for using XrayDetector!<\/p>\n","protected":false},"excerpt":{"rendered":" A lightweight plugin that sends alerts to the staff team when it suspects that someone is X-raying<\/p>\n","protected":false},"featured_media":172662,"template":"","meta":{"_minecraft_slug":"xraydetector","_minecraft_project_id":"NjKf0tyX","_minecraft_author":"Nevmind","_minecraft_license":"CC-BY-ND-4.0","_minecraft_downloads":2939,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"xraydetector.zip","_minecraft_size_bytes":24469,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T05:13:45.161184Z","_minecraft_date_created":"2025-10-11T06:03:16.439037Z","_minecraft_date_modified":"2025-10-10T15:31:12.546194Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/xraydetector","_minecraft_icon_attachment_id":172662,"_minecraft_imported_at":"2026-06-09T22:16:42+00:00","_minecraft_import_hash":"39591dcbd5cc97bedf6c528668bedf17","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,126,127,128,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-172661","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `\/xray toggle` – Enable or disable the detection system
\n– `\/xray set ores
\n– `\/xray set time
\n– `\/xray tp
\n– `\/xray chances list` – View top 10 players with highest X-ray suspicion points
\n– `\/xray reload` – Reload configuration without restarting<\/p>\n
\n– **Customizable Thresholds**: Adjust ore counts and time windows
\n– **Severity Levels**: Configure point values for each severity tier
\n– **Alert Colors**: Customize message colors using Minecraft color codes
\n– **Toggle System**: Enable\/disable detection without removing the plugin<\/p>\n
\n– `xray.admin` – Access to all plugin commands (default: op)
\n– `xray.alerts` – Receive X-ray detection alerts (default: op)<\/p>\n
\n2. Place the JAR file in your server’s `plugins` folder
\n3. Restart your server or use a plugin manager to load it
\n4. Configure the plugin in `plugins\/XrayDetector\/config.yml`<\/p>\n
\n– **Paper** (Recommended)
\n– **Spigot**
\n– **Bukkit**
\n– **PurPur**
\n– **Pufferfish**<\/p>\n
\n– **1.21.x** (Latest)
\n– **1.20.x**
\n– **1.19.x**
\n– **1.18.x**
\n– **1.17.x**
\n– **1.16.x**
\n– **1.15.x**
\n– **1.14.x**
\n– **1.13+** (Minimum)<\/p>\n
\n“`yaml
\n# Enable or disable detection system
\nenabled: true<\/p>\n
\nores_threshold: 10<\/p>\n
\ntime_window: 60
\n“`<\/p>\n
\nEach severity level can be configured with minimum\/maximum ore counts and point values:
\n– **Low**: 5-10 ores (5 points)
\n– **Medium**: 11-20 ores (15 points)
\n– **High**: 21-35 ores (30 points)
\n– **Very High**: 36+ ores (50 points)<\/p>\n
\nCustomize alert message colors using Minecraft color codes:
\n– `&b` = Aqua (Light Blue)
\n– `&f` = White
\n– `&e` = Yellow
\n– `&6` = Gold
\n– `&c` = Red
\n– `&4` = Dark Red<\/p>\n
\n1. **Monitoring**: The plugin tracks when players mine ore blocks
\n2. **Pattern Analysis**: Calculates mining speed (ores per second) within the time window
\n3. **Severity Assessment**: Determines alert level based on ore count and mining speed
\n4. **Point Assignment**: Adds points to the player’s X-ray suspicion score
\n5. **Staff Notification**: Sends formatted alerts to all staff with `xray.alerts` permission<\/p>\n
\nThe plugin monitors all ore types including:
\n– Coal, Iron, Gold, Diamond, Emerald
\n– Lapis Lazuli, Redstone, Copper
\n– Nether Gold, Nether Quartz
\n– Ancient Debris
\n– Deepslate variants of all ores<\/p>\n
\n“`
\n[XrayDetector] PlayerName mined 15 ores in 30.0 seconds [MEDIUM] (+15 points, Total: 45)
\n“`<\/p>\n
\n|———|———–|————-|
\n| `\/xray toggle` | `xray.admin` | Toggle detection on\/off |
\n| `\/xray set ores
\n| `\/xray set time
\n| `\/xray tp
\n| `\/xray chances list` | `xray.admin` | Show top suspects |
\n| `\/xray reload` | `xray.admin` | Reload configuration |<\/p>\n
\nA: No, this plugin only detects potential X-ray usage. It cannot prevent players from using X-ray texture packs or mods.<\/p>\n
\nA: 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.<\/p>\n
\nA: Only players with the `xray.alerts` permission (typically staff) receive alerts.<\/p>\n
\nA: The plugin only sends alerts and tracks points. Staff must manually review and take appropriate action.<\/p>\n
\nA: The plugin requires Minecraft 1.13 or newer due to API compatibility.<\/p>\n
\n– Open an issue on the project repository
\n– Contact the server administrator<\/p>\n
\n**All Rights Reserved**<\/p>\n
\n**Plugin Version:** 1.0.0
\n**Last Updated:** 2025<\/p>\n