ModsJava
xray-alert
Java mod listed for Minecraft 1.8–1.19. File opened and checked on 4 Oct 2026; downloads from the MC Java Mods app on Android.
⬇ Download on Spigotxray-alert
A Spigot plugin that alerts staff members when a player mines an unusually large number of ores (or ore veins) within a configurable time window, helping detect possible X-Ray usage.
Features
Permission Default Description
xrayalerts.alert op Receive xray alerts
xrayalerts.admin op Use /xrayalert commands
xrayalerts.bypass false Skip xray monitoring entirely
Commands
Command Description
/xrayalert reload Reload config.yml and reset tracked data
Configuration (config.yml)
Installation
A Spigot plugin that alerts staff members when a player mines an unusually large number of ores (or ore veins) within a configurable time window, helping detect possible X-Ray usage.
Features
- Supports Minecraft 1.8 through 1.21+ with version-aware monitored ore lists
- Monitors major overworld and nether ores for each supported version (including deepslate variants where available)
- Vein-aware tracking: connected ore blocks from the same vein are counted once
- Per-ore configurable thresholds and a global sliding time window
- Alerts all online players with the xrayalerts.alert permission
- Per-player, per-ore alert cooldown to avoid spam
- Bypass permission for trusted players
- Fully customisable alert message with placeholders
- /xrayalert reload command to hot-reload the configuration
Permission Default Description
xrayalerts.alert op Receive xray alerts
xrayalerts.admin op Use /xrayalert commands
xrayalerts.bypass false Skip xray monitoring entirely
Commands
Command Description
/xrayalert reload Reload config.yml and reset tracked data
Configuration (config.yml)
Code (YAML):
# Sliding time window in seconds
time-window : 60
# Minimum seconds between repeated alerts for the same player + ore
alert-cooldown : 30
# Vein cache window in seconds (how long counted vein blocks remain cached)
vein-cache-seconds : 300
# Safety cap for connected-block vein scanning
max-vein-scan-blocks : 128
# Alert message (supports & colour codes)
# Placeholders: {player}, {ore}, {count}, {threshold}, {window}
alert-message : "&c[XrayAlert] &f{player} &cmined &f{count}x {ore} &cin &f{window}s &c(threshold: &f{threshold}&c)"
thresholds:
DIAMOND_ORE : 5
DEEPSLATE_DIAMOND_ORE : 5
ANCIENT_DEBRIS : 3
# Set any ore to -1 to disable monitoring for that ore
# ... (all ores are listed in the default config)
time-window : 60
# Minimum seconds between repeated alerts for the same player + ore
alert-cooldown : 30
# Vein cache window in seconds (how long counted vein blocks remain cached)
vein-cache-seconds : 300
# Safety cap for connected-block vein scanning
max-vein-scan-blocks : 128
# Alert message (supports & colour codes)
# Placeholders: {player}, {ore}, {count}, {threshold}, {window}
alert-message : "&c[XrayAlert] &f{player} &cmined &f{count}x {ore} &cin &f{window}s &c(threshold: &f{threshold}&c)"
thresholds:
DIAMOND_ORE : 5
DEEPSLATE_DIAMOND_ORE : 5
ANCIENT_DEBRIS : 3
# Set any ore to -1 to disable monitoring for that ore
# ... (all ores are listed in the default config)
Installation
- Drop the jar into your server's plugins/ folder.
- Start or restart the server — plugins/XrayAlert/config.yml is created automatically.
- Edit config.yml to suit your thresholds, then run /xrayalert reload.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.8, 1.9, 1.10
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
xray-alert is a free Minecraft Java mod. Compatible with Minecraft 1.8, 1.9, 1.10, 1.11 and newer. Downloaded 56 times (via Spigot). Download it and open it directly in the game.