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
```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:
- 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)
```

---

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

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!

X-RayDetector