XrayDetector

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.

All Rights Reserved nevmind All Rights Reserved 1.0.0 All Rights Reserved

---

Features

Core Detection System

- Real-Time Alerts: Monitors ore mining frequency and speed to identify suspicious patterns - Real-Time Alerts: Classifies alerts as Low, Medium, High, or Very High based on mining behavior - Real-Time Alerts: 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

- Toggle System: Adjust ore counts and time windows - Toggle System: Configure point values for each severity tier - Toggle System: 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

- Pufferfish (Recommended) - Pufferfish - Pufferfish - Pufferfish - Pufferfish

Minecraft Versions

- 1.13+ (Latest) - 1.13+ - 1.13+ - 1.13+ - 1.13+ - 1.13+ - 1.13+ - 1.13+ - 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

```yaml

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: - Very High: 5-10 ores (5 points) - Very High: 11-20 ores (15 points) - Very 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. Staff Notification: The plugin tracks when players mine ore blocks 2. Staff Notification: Calculates mining speed (ores per second) within the time window 3. Staff Notification: Determines alert level based on ore count and mining speed 4. Staff Notification: 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

All Rights Reserved by All Rights Reserved All Rights Reserved

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

---

Credits

Last Updated: nevmind Last Updated: 1.0.0 Last Updated: 2025

Thank you for using XrayDetector!