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.

**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 ` – Configure ore threshold for alerts
– `/xray set time ` – Set the time window for detection
– `/xray tp ` – 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)
“`

—

## Commands & Permissions

| Command | Permission | Description |
|———|———–|————-|
| `/xray toggle` | `xray.admin` | Toggle detection on/off |
| `/xray set ores ` | `xray.admin` | Set ore threshold |
| `/xray set time ` | `xray.admin` | Set time window |
| `/xray tp ` | `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!

Xray Boat


🚤 X-Ray Boat lets you see straight through the boat and into the ocean below.
The main idea of this texture is simple and useful: with a transparent/open boat, you can clearly see the seafloor, corals, ruins, and underwater terrain while sailing. 🌊👀

It keeps a clean, vanilla-friendly look, but adds a practical and immersive detail that makes ocean exploration way more enjoyable. Perfect for discovering what’s beneath the water without leaving your boat. 🌿✨

Lightweight, simple, and visually pleasing — a small tweak that changes how you explore the seas. 🚣‍♂️

XPlayerKits

It’s a plugin that allows you to create kits for your players.
This plugin was created due to the lack of an optimized solution for this feature.
It uses very little RAM and is highly customizable.

| | | |
| — | — | — |

**Unlike other plugins that load the data of every single player registered on your server (wasting precious resources), XPlayerKits takes a smarter approach.**
It only loads player data when they actually join, and keeps just the essential information cached. This means **significantly lower RAM usage** without sacrificing performance.

On top of that, XPlayerKits comes with **built-in SQLite support right out of the box**, giving you a reliable and lightweight database solution. No more dealing with the limitations and issues of storing player data in messy YML files.

### Features
– **Migration:** Migrate data and kits from another plugin to save resources and avoid inventory exploits.
– **Kit placeholder requirements:** Use a system to check placeholder conditions.
– **Fully editable inventory:** Customize the kit inventory with an item name system for icons.
– **Claim/Deny actions:** Set actions when claiming or denying a kit, such as commands or sounds.
– **In-game GUI:** Edit kits directly in-game, including properties, icons, and content.
– **One-Time Kits:** Create kits that can only be claimed once, stored in player data.
– **First Join Kit:** Deliver a kit to players the first time they join your server.
– **Database support:** MongoDB, MySQL, and SQLite are supported (Recommended: MongoDB).

### Commands
– `/xkits editor` – Opens the editor for quick kit creation.
– `/xkits kits` – Opens the kit selection menu.
– `/xkits open [rotation/category]` – Opens the kit selection with category or rotation kits.
– `/xkits preview [player]` – Opens preview menu.
– `/xkits give ` – Give kits directly to players without checks.
– `/xkits claim ` – Give kits to players with checks.
– `/xkits reset ` – Reset a player’s data for a specific kit.
– `/xkits resetall ` – Reset all data for a player.
– `/xkits delete ` – Delete a kit.
– `/xkits migrate playerkits2_yml/playerkits2_mysql` – Migrate data from other plugins.
– `/xkits migratekits playerkits2` – Migrate kits from other plugins.

### Permissions
– `xkits.admin` – Allows players to use the `/xkits editor` and `/xkits slots` commands.
– `xkits.preview` – Allows players to use `/xkits preview`.
– `xkits.countdown.bypass` – Allows players to bypass kit countdowns.
– `xkits.onetime.bypass` – Allows players to bypass one-time restrictions.

### Placeholders
– `%xplayerkits_cooldown_%` – Show the time to next claim.
– `%xplayerkits_claimed_onetime_%` – Return yes or no if the kit of player is claimed.
– `%xplayerkits_claimed_cooldown_%` – Return yes or no if the kit of player is in cooldown.

### Actions
| Action | Description | Example |
|————————-|———————————————–|———————————————————–|
| console | Executes a command from the console. | `console:say test` |
| command | Executes a command as the player. | `command:dm open main` |
| sound | Plays a sound to the player. | `sound:ENTITY_ENDERMAN_TELEPORT;1.0f;1.0f` |
| playsound_resource_pack | Plays a sound from a resource pack. | `playsound_resource_pack:ENTITY_ENDERMAN_TELEPORT;1.0f;1.0f` |
| message | Sends a chat message to the player. | `message:You can’t claim this kit.` |
| center_message | Sends a centered message to the player. | `center_message:You can’t claim this kit.` |
| mini_message | Sends a MiniMessage formatted message. | `mini_message:You can’t claim this kit.` |
| broadcast | Sends a message to all players. | `broadcast:You can’t claim this kit.` |
| titles | Sends a title and subtitle to the player. | `titles: