# XRayAlerts<\/p>\n
**XRayAlerts** is a plugin for Paper\/Spigot servers that can alert staff members (or any player with the appropriate permission) whenever a player finds specific ores or items. It supports customizable alerts, configurable monitoring modes, and permission-based access control. The plugin is compatible with both Paper and Spigot servers running Minecraft 1.21+. Earlier versions have not been tested.<\/p>\n
## Features<\/p>\n
– **Configurable Alerts**: Customize the messages sent to staff when a player finds a monitored item or ore. Messages support color and formatting codes.
\n– **Vein Detection Mode**: Choose between two modes:
\n – **Block Mode**: Sends an alert for each block mined, indicating the number of items dropped.
\n – **Vein Mode**: Sends one alert for the entire vein when the first block in the vein is mined.
\n– **Permission Control**: Permissions to toggle alerts, receive alerts, and ignore alerts.<\/p>\n
## Commands<\/p>\n
### `\/xrayalerts toggle`
\nToggles the x-ray alerts on or off for the player who runs the command.
\n**Permission**: `xrayalerts.toggle`
\n**Usage**: `\/xrayalerts toggle`<\/p>\n
## Permissions<\/p>\n
– **`xrayalerts.ignore`**: Prevents x-ray alerts from being triggered by the player.
\n– **`xrayalerts.receive`**: Allows the player to receive x-ray alerts.
\n– **`xrayalerts.toggle`**: Allows the player to toggle x-ray alerts on or off.<\/p>\n
## Configuration<\/p>\n
### `config.yml`
\n“`yaml
\nalert-message: “&c&lX-Ray&r &7%player% found &6x%count% %item%.”<\/p>\n
mode: “block” # Options: “block”, “vein”<\/p>\n
monitored-blocks:
\n – ANCIENT_DEBRIS
\n – DEEPSLATE_DIAMOND_ORE
\n – DEEPSLATE_EMERALD_ORE
\n – DEEPSLATE_GOLD_ORE
\n – DIAMOND_ORE
\n – EMERALD_ORE
\n – GOLD_ORE
\n“`<\/p>\n","protected":false},"excerpt":{"rendered":"
XRayAlerts is a plugin for Paper\/Spigot servers that can alert staff members whenever a player finds specific ores or items.<\/p>\n","protected":false},"featured_media":172660,"template":"","meta":{"_minecraft_slug":"xrayalerts","_minecraft_project_id":"l0FBOquA","_minecraft_author":"tjrgg","_minecraft_license":"MIT","_minecraft_downloads":4485,"_minecraft_follows":8,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"xrayalerts.zip","_minecraft_size_bytes":8237,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T03:56:22.484347Z","_minecraft_date_created":"2024-08-19T20:41:24.405079Z","_minecraft_date_modified":"2024-08-18T20:05:28.459266Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/xrayalerts","_minecraft_icon_attachment_id":172660,"_minecraft_imported_at":"2026-06-09T22:16:40+00:00","_minecraft_import_hash":"a3670b40beb7a267dedeff9518ae9e05","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,126,127,129,92],"mod_loader":[130,132,134],"minecraft_version":[62,37],"class_list":["post-172659","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-management","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1"],"yoast_head":"\n