X-RayDetector: The Ultimate Minecraft Anti-Xray Plugin for Server Admins
Maintaining a fair and enjoyable Minecraft server is a constant challenge. One of the most persistent issues server administrators face is the use of X-ray mods or texture packs that allow players to see through blocks and locate valuable ores instantly. While there is no perfect solution to prevent X-ray entirely, the X-RayDetector plugin offers a powerful tool to identify suspicious mining behavior and alert staff in real time. Developed by nevmind, this plugin uses pattern-based detection to track ore mining frequency and speed, helping you catch potential cheaters before they ruin the economy.
What is X-RayDetector?
X-RayDetector is a comprehensive detection plugin for Minecraft servers running Paper, Spigot, Bukkit, and similar server software. Unlike some anti-xray plugins that attempt to obfuscate ores, X-RayDetector focuses on monitoring player behavior. It tracks how many ores a player mines within a configurable time window and calculates their mining speed. If the pattern exceeds normal gameplay thresholds, the plugin sends a formatted alert to staff members and assigns suspicion points to the player. Over time, these points accumulate, giving moderators a clear picture of who might be using X-ray.
Key Features
Intelligent Pattern-Based Detection
The core of X-RayDetector lies in its ability to analyze mining patterns. Instead of simply counting ores, it evaluates the rate at which players find and mine ore blocks. A legitimate miner will typically encounter ores at a natural pace, while an X-ray user will rapidly target only valuable blocks. The plugin's four-tier severity system—Low, Medium, High, and Very High—classifies alerts based on the number of ores mined within the time window, making it easy for staff to prioritize investigations.
Real-Time Staff Alerts
When a player triggers a detection threshold, the plugin instantly notifies all online staff members with the appropriate permission. The alert message includes the player's name, the number of ores mined, the time taken, the severity level, and the player's total suspicion points. This immediate feedback allows moderators to spectate the player and gather evidence before the cheater logs off.
Comprehensive Command System
X-RayDetector comes with a set of intuitive commands that give admins full control:
- /xray toggle – Enable or disable the detection system on the fly.
- /xray set ores <number> – Adjust the ore threshold that triggers an alert.
- /xray set time <seconds> – Modify the time window for detection.
- /xray tp <player> – Teleport to a suspected player in spectator mode (invisible) to observe them without interference.
- /xray chances list – View the top 10 players with the highest accumulated suspicion points.
- /xray reload – Reload the configuration without restarting the server.
Points Tracking and History
Every detection adds points to a player's cumulative X-ray suspicion score. Staff can use the /xray chances list command to see a leaderboard of the most suspicious players, making it easy to identify repeat offenders. This system helps build a case over time, rather than relying on a single alert.
How the Detection System Works
The plugin monitors all ore blocks, including coal, iron, gold, diamond, emerald, lapis lazuli, redstone, copper, nether gold, nether quartz, ancient debris, and their deepslate variants. When a player mines an ore, the plugin records the event. Within the configured time window (default 60 seconds), it counts the total ores mined and calculates the mining speed. If the count exceeds the threshold (default 10 ores), an alert is generated. The severity level is determined by the number of ores: Low (5-10), Medium (11-20), High (21-35), and Very High (36+). Each level assigns a different point value, which is added to the player's total.
It's important to note that X-RayDetector does not prevent X-ray usage; it only detects suspicious patterns. This makes it a valuable tool for server moderation, but it should be used alongside other methods like ore obfuscation plugins or manual review.
Installation and Setup
Installing X-RayDetector is straightforward. First, download the XrayDetector-1.0.0.jar file from the official releases page. Place the JAR file into your server's plugins folder, then restart the server or use a plugin manager to load it. Once loaded, the plugin will generate a default configuration file at plugins/XrayDetector/config.yml, which you can customize to fit your server's needs.
While X-RayDetector is a server-side plugin, if you're looking to enhance your single-player or client-side experience with mods, the foxygame.net launcher provides a convenient, flexible, and modern way to download and install mods directly from its menu. It's a great tool for players who want to explore new content without the hassle of manual mod installation.
Configuration Options
The config.yml file allows you to fine-tune the detection parameters. You can enable or disable the system, set the ore threshold, and adjust the time window. Each severity level can be customized with minimum/maximum ore counts and point values. For example, you might lower the threshold for a small server where rapid mining is more suspicious. Alert colors can also be personalized using Minecraft color codes, so messages stand out in chat.
Commands and Permissions
The plugin uses two main permissions: xray.admin (default for ops) grants access to all commands, and xray.alerts (default for ops) allows receiving detection alerts. You can assign these permissions to your moderator group using any permissions manager.
Compatibility
X-RayDetector is built on the Bukkit API 1.13+ and supports a wide range of server platforms, including Paper (recommended), Spigot, Bukkit, PurPur, and Pufferfish. It works with Minecraft versions from 1.13 up to the latest 1.21.x, ensuring broad compatibility for most servers.
FAQ Highlights
Here are some common questions server admins have:
- Does this plugin prevent X-ray? No, it only detects potential X-ray usage. It cannot block X-ray texture packs or mods.
- Will it catch all X-ray users? The plugin identifies suspicious patterns, but it's not 100% accurate. It should be used as one tool among many for moderation.
- Can players see the alerts? Only players with the xray.alerts permission (typically staff) receive alerts.
- What happens when a player is detected? The plugin sends alerts and tracks points. Staff must manually review and take action.
- Does it work on older versions? The plugin requires Minecraft 1.13 or newer due to API compatibility.
Conclusion
X-RayDetector is an essential addition to any Minecraft server administrator's toolkit. Its pattern-based detection, real-time alerts, and cumulative points system provide a robust method for identifying potential X-ray users without impacting server performance. While it doesn't replace the need for active moderation, it significantly reduces the time staff spend hunting for cheaters. By combining this plugin with a fair set of rules and regular monitoring, you can maintain a balanced and enjoyable environment for all players. Download the plugin, configure it to your liking, and start catching those suspicious miners today.