**⚠️ NOTICE: This plugin is in beta. There may be bugs or issues, and not all planned features have been implemented yet. Join our Discord ( https://discord.gg/sW7zu4RXmD) for support, announcements and to report bugs.**

VeinGuard is a lightweight Anti-Xray plugin designed to help server staff identify suspicious mining behavior. The plugin monitors block break activity in real time and tracks specific blocks defined in the configuration.

When a player breaks a tracked block, the action is recorded in memory. If the player exceeds the configured number of breaks for that block within the defined parameters, VeinGuard automatically alerts staff members. Alerts can be delivered through in-game notifications, console notifications, or both, allowing staff to respond quickly and effectively.

VeinGuard is designed to be simple and configurable, making it easy for server owners to moderate potential X-ray abuse without impacting server performance.

Features

- Real-time tracking of block break activity for configurable blocks
- Fully configurable block thresholds per material
- Supports all Minecraft blocks.
- Time-based tracking window (e.g. blocks broken in the last X minutes)
- Per-block alert cooldowns to prevent notification spam
- In-game staff alerts with configurable messages
- Automatic formatting of block names with custom display names
- Ignore players in Creative mode (Configurable)
- Ignore block breaks above a configurable Y-level (Configurable)
- Ignore specific tools (Configurable)
- Disable tracking in specific worlds (Configurable)
- Per-player mute system for alert notifications
- Staff can toggle off receiving alerts
- Detailed player reports showing block counts and violation status
- Visual distinction between normal activity and violations in reports
- Paginated report message for better report viewing
- Permission-based bypass for trusted players
- Hot-reload support for configuration and messages


Permissions

> Grant the permission veinguard.admin to provide access to all staff-related commands and notifications.

> Grant the permission veinguard.mod to your moderators. This permission grants the following permissions: veinguard.notify, veinguard.bypass, veinguard.command, veinguard.command.check, veinguard.help, veinguard.toggle-alerts

- veinguard.command
Allows access to the /veinguard (/vg) command and its available subcommands.

- veinguard.notify
Receives in-game X-ray alert notifications when suspicious mining activity is detected.

- veinguard.bypass
Exempts the player from all VeinGuard block tracking and detection checks.

Base Command

- /veinguard or /vg
- Permission: veinguard.command
- Displays general plugin information and how to view plugin help.

Player Commands

- /vg check <player> or /vg check <player> <page>
- Permission: veinguard.command.check
- View a detailed report of a player’s tracked block break history.
- Paginated, limiting 7 tracked-blocks per page, configurable in config.yml.

- /vg mute <player>
- Permission: veinguard.command.mute
- Temporarily mute alert notifications for a specific suspect player. This will mute notifications for players with the permission veinguard.notify

- /vg toggle-alerts or /vg toggle-alerts <player>
- Permission: veinguard.command.toggle-alerts and veinguard.command.toggle-alerts.others
- Toggle all notifications for yourself or a specific player.

- /vg unmute <player>
- Permission: veinguard.command.unmute
- Re-enable alert notifications for a previously muted player. This will unmute notifications for players with the permission veinguard.notify

Data Management Commands

- /vg reset <player>
- Permission: `veinguard.command.reset`
- Reset a specific player’s tracked block break history.

- /vg resetall
- Permission: `veinguard.command.resetall`
- Reset tracked block break history for all players.

Administration Commands

- /vg reload
- Permission: veinguard.command.reload
- Reload the plugin and all configuration files without restarting the server.


Join Our Discord

Connect with the community, get support, and stay updated on VeinGuard updates:

https://discord.gg/sW7zu4RXmD


Please refrain from asking for support in the reviews! If you need support please join our Discord server above!

Also the discussion page on this plugin is not actively monitored!