![\"VeinGuard](\"https:\/\/cdn.modrinth.com\/data\/zIQ58sDz\/images\/aff0b7e49978da17e613b2034ad7cccaa2774dfb.png\")
\n<\/p>\n\n \n<\/p>\n
\n
![\"Modrinth\"](\"https:\/\/raw.githubusercontent.com\/vLuckyyy\/badges\/main\/avaiable-on-modrinth.svg\")
<\/p>\n
![\"SpigotMC\"](\"https:\/\/raw.githubusercontent.com\/vLuckyyy\/badges\/main\/available-on-spigotmc.svg\")
<\/p>\n
![\"Hangar\"](\"https:\/\/raw.githubusercontent.com\/vLuckyyy\/badges\/main\/avaiable-on-hangar.svg\")
<\/p>\n
![\"Hangar\"](\"https:\/\/raw.githubusercontent.com\/intergrav\/devins-badges\/refs\/heads\/v3\/assets\/cozy\/available\/curseforge_vector.svg\")
<\/p>\n
![\"bStats\"](\"https:\/\/raw.githubusercontent.com\/vLuckyyy\/badges\/main\/available-on-bstats.svg\")
<\/p>\n
\n
![\"Discord\"](\"https:\/\/raw.githubusercontent.com\/intergrav\/devins-badges\/refs\/heads\/v3\/assets\/compact\/social\/discord-plural_vector.svg\")
<\/p>\n
\n ![\"Passing\"](\"https:\/\/github.com\/jerrysplugins\/veinguard\/actions\/workflows\/maven.yml\/badge.svg\"){kind=icon}
\n
\n \n<\/p>\n
<\/p>\n
**VeinGuard** is a lightweight plugin that helps server staff detect potential x-rayers. It tracks block breaks in real time for blocks defined in the configuration.<\/p>\n
When a player exceeds the configured break limits, VeinGuard alerts staff via in-game messages, console logs, or a Discord webhook, enabling quick responses.<\/p>\n
VeinGuard is simple, configurable, and designed to moderate X-ray abuse without impacting server performance.<\/p>\n
**\u26a0\ufe0f NOTICE: Not all planned features have been implemented yet!**<\/p>\n
—<\/p>\n
<\/p>\n
– Tracks how many tracked blocks players break in a configured time (minutes)
\n– Supports all block types with configurable limits
\n– Prevents spam alerts by using cooldowns per tracked block or per alert
\n– Advanced patrol system to patrol all online players
\n– Sends alerts to staff in-game, console, and Discord webhook
\n– Runs configurable commands when an alert is triggered
\n– Allows staff to mute or toggle alerts
\n– Generates clear player reports with block counts and violations
\n– Supports large reports with pagination
\n– Ignores creative mode players, certain tools, worlds, and above certain Y-levels
\n– Permission-based bypasses
\n– WorldGuard integration: Use the `veinguard-check` custom flag to enable\/disable tracking in specific regions
\n– Reload configs and language files without restarting the server<\/p>\n
—<\/p>\n
<\/p>\n
## Requirements<\/p>\n
Before installing **VeinGuard**, make sure your server meets the following requirements:<\/p>\n
– **Java 16 or newer**
\n– One of the following server types: Spigot, Paper, Purpur(1.21+) or any compatible fork.
\n– Minecraft 1.17+ if using Spigot or Paper.
\n—<\/p>\n
## Installation<\/p>\n
1. Download the latest **VeinGuard** `.jar` file from: Spigot, Modrinth, Hangar or Github.<\/p>\n
2. Place the VeinGuard `.jar` file into your server\u2019s `plugins` folder.<\/p>\n
3. Start the server once to generate VeinGuard\u2019s configuration files.<\/p>\n
4. Edit the configuration files to your liking, then apply changes by:
\n – Running `\/vg reload`, **or**
\n – Restarting the server<\/p>\n
<\/p>\n <\/p>\n ### Permissions<\/p>\n > Grant the permission `veinguard.admin` to provide access to all features.<\/p>\n > Grant the permission `veinguard.mod` to your moderators. This permission grants the following permissions: `veinguard.notify` `veinguard.bypass` `veinguard.command` `veinguard.command.check` `veinguard.command.help` `veinguard.command.toggle-alerts` `veinguard.command.tracked-blocks.list`<\/p>\n You are also free to ignore ^ these permissions and configure them as you please!<\/p>\n – **`veinguard.notify`** – **`veinguard.bypass`** – **`veinguard.bypass.MATERIAL`** – **`veinguard.update`** —<\/p>\n ### Base Command<\/p>\n – **\/veinguard** or **\/vg** – **\/veinguard help** ### Player Commands<\/p>\n – **\/vg check – **\/vg msg – **\/vg mute – **\/vg patrol – **\/vg toggle-alerts** – **\/vg tracked-blocks – **\/vg unmute ### Data Management<\/p>\n – **\/vg reset – **\/vg resetall** ### Administration<\/p>\n – **\/vg reload** ## VeinGuard Plugin Wiki<\/p>\n Explore the full **VeinGuard Wiki** for detailed information about the plugin, including commands, permissions, configuration options, installation guides, and more.<\/p>\n Visit the VeinGuard Wiki<\/p>\n ## Report Issues\/Bugs<\/p>\n Find a bug or an error? Report it here on our issue tracker:<\/p>\n Issue Tracker<\/p>\n ## Join Our Discord<\/p>\n Get support and stay updated on VeinGuard updates:<\/p>\n Join the VeinGuard Discord<\/p>\n ## Plugin Metrics<\/p>\n VeinGuard uses bStats to collect anonymous usage data. Click to view plugin metrics:<\/p>\n View Metrics Easy-to-use Xray detection plugin that alerts staff to excessive ore mining. Fully configurable!<\/p>\n","protected":false},"featured_media":165456,"template":"","meta":{"_minecraft_slug":"veinguard","_minecraft_project_id":"zIQ58sDz","_minecraft_author":"JerrysPlugins","_minecraft_license":"MIT","_minecraft_downloads":282,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"veinguard.zip","_minecraft_size_bytes":940865,"_minecraft_version_count":13,"_minecraft_updated_at":"2026-05-16T12:02:02.933635Z","_minecraft_date_created":"2026-01-24T20:15:06.416943Z","_minecraft_date_modified":"2026-02-21T13:10:07.964821Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/veinguard","_minecraft_icon_attachment_id":165456,"_minecraft_imported_at":"2026-06-09T17:46:43+00:00","_minecraft_import_hash":"bb79393d26f1827895694dfbd280c518","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,126,127,128,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-165455","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n\nCommands & Permissions<\/strong><\/summary>\n
\n Receives in-game alert notifications when suspicious mining activity is detected.<\/p>\n
\n Exempts the player from all VeinGuard block tracking and detection checks.<\/p>\n
\n Exempts the player from block-break tracking for a specific material. Material is CASE SENSITIVE!
\n Example: `veinguard.bypass.DIAMOND_ORE`
\n Intended for staff members or trusted roles.<\/p>\n
\n Allows the player to receive VeinGuard update notifications.<\/p>\n
\n – Permission: `veinguard.command`
\n – Displays general plugin information and how to view plugin help.<\/p>\n
\n – Permission: `veinguard.help`
\n – Displays help message for plugin commands and features.<\/p>\n
\n – Permission: `veinguard.command.check`
\n – View a detailed report of a player\u2019s tracked block break history.
\n – Paginated, limiting 7 tracked-blocks per page, configurable in config.yml.<\/p>\n
\n – Permission: `veinguard.command.msg`
\n – Sends a formatted message to the targeted player, with no prefix, used in the config for ‘alert-commands’.<\/p>\n
\n – Permission: `veinguard.command.mute`
\n – Temporarily mute alert notifications for a specific suspect player. This will mute notifications for players with the permission `veinguard.notify`<\/p>\n
\n – Permission: `veinguard.command.patrol`
\n – Patrol through all online players with an automated cycle and boss bar display.<\/p>\n
\n – Permission: `veinguard.command.toggle-alerts`
\n – Toggle all alert notifications for yourself.<\/p>\n
\n – Permissions: `veinguard.command.tracked-blocks.add` `veinguard.command.tracked-blocks.list` `veinguard.command.tracked-blocks.remove`
\n – Add, list or remove tracked blocks in real time without updating the config.yml manually.<\/p>\n
\n – Permission: `veinguard.command.unmute`
\n – Re-enable alert notifications for a previously muted player. This will unmute notifications for players with the permission `veinguard.notify`<\/p>\n
\n – Permission: `veinguard.command.reset`
\n – Reset a specific player\u2019s tracked block break history.<\/p>\n
\n – Permission: `veinguard.command.resetall`
\n – Reset tracked block break history for all players.<\/p>\n
\n – Permission: `veinguard.command.reload`
\n – Reload the plugin and all configuration files without restarting the server.<\/p>\n<\/details>\n
\n![\"ModPanel\"\/](\"https:\/\/bstats.org\/signatures\/bukkit\/VeinGuard.svg\")
<\/p>\n","protected":false},"excerpt":{"rendered":"