What Is VeinGuard and Why Your Minecraft Server Needs It
Running a Minecraft server is a balancing act. You want players to enjoy the thrill of mining diamonds or ancient debris, but a few bad actors using x-ray hacks can ruin the economy and trust. Traditional anti-xray plugins often hide ores until they are exposed, which can cause visual glitches and performance overhead. VeinGuard takes a completely different approach. Instead of obfuscating blocks, it watches how players mine and flags suspicious behavior in real time. This behavioral detection model is lightweight, highly configurable, and gives your staff concrete evidence to act on.
How Behavioral Detection Outperforms Ore Obfuscation
Ore obfuscation works by showing stone or cobblestone until a block is naturally revealed, but it can be bypassed by sophisticated cheat clients and often creates lag on larger servers. VeinGuard focuses on the player, not the block. It tracks specific block types you define—like diamond ore, emerald ore, or netherite—and calculates break rates over a configurable timeframe. If someone mines 15 diamonds in 5 minutes in scattered locations, that pattern is statistically improbable. VeinGuard flags it, groups consecutive alerts into a single “mining incident,” and notifies your staff via chat, action bar, or Discord webhook. This means fewer false positives and a smoother experience for legitimate miners.
Core Detection Mechanics
- Intelligent Tracking: Monitor any block type you choose, with per-block thresholds and time windows.
- Violation Level (VL) System: Each alert adds a suspicion score that decays over time, preventing permanent punishment for a single mistake.
- Mining Incident Model: Consecutive alerts are bundled into one incident, giving staff a clean overview instead of spam.
- Anti-Spam Logic: Cooldowns per block or per alert keep notifications manageable.
Multi-Channel Alerts That Keep Staff Informed
When a potential x-rayer is detected, VeinGuard can instantly notify your team through multiple channels. In-game alerts appear in chat or on the action bar for online moderators. Discord integration sends detailed webhook messages—including coordinates, light level, and block counts—directly to a private staff channel. Console logging provides a permanent record for later review. You can even set automated actions: when a player’s VL hits a certain threshold, VeinGuard executes a custom command like /freeze, /mute, or /kick, buying time for investigation without manual intervention.
Powerful Staff Tools for Investigation
VeinGuard isn’t just a detection bot; it’s a full investigation suite. The Advanced Patrol System lets staff cycle through online players in spectator mode with a boss bar tracking their status. The /vg check command generates an instant report of a player’s recent mining activity, showing exact block counts and highlighted violations. For offline suspects, /vg history pulls data from the persistent database (SQLite or MySQL). Leaderboards via /vg top reveal the worst offenders over time. Staff can also mute alerts for trusted players or toggle their own notification visibility, making the tool adaptable to any workflow.
Customization and Seamless Integration
Every server is different, so VeinGuard offers granular control. You can exempt players via permissions globally or for specific materials (e.g., veinguard.bypass.DIAMOND_ORE). WorldGuard support allows you to disable tracking in designated public mines using the veinguard-check flag. The plugin automatically ignores creative-mode players, specific worlds, or anyone above a defined Y-level. Configuration and language files can be reloaded on the fly with /vg reload, no restart needed. This flexibility makes it easy to tailor the anti-xray system to your server’s unique rules.
For those who want a hassle-free setup, many server owners find that this mod can be easily installed via the foxygame.net launcher — a convenient, flexible, and modern Minecraft launcher where you can download mods right from the menu. It streamlines the process of adding plugins like VeinGuard to your server environment without digging through multiple sites.
Getting Started with VeinGuard
Installation is straightforward. Download the latest .jar from Spigot, Modrinth, Hangar, or GitHub, and drop it into your server’s plugins folder. Start the server to generate default config files, then adjust config.yml and lang.yml to your liking. Define which blocks to track, set thresholds, and configure automated actions. Run /vg reload to apply changes instantly. The plugin requires Java 17 or newer and supports Spigot, Paper, Purpur (1.21+), and any compatible fork running Minecraft 1.18 or above.
Understanding a Mining Incident Step by Step
Here’s how a typical detection unfolds:
- A player mines a tracked block, and VeinGuard records the event.
- If the break rate exceeds your threshold (e.g., 15 diamonds in 5 minutes), an alert triggers.
- Staff receive in-game and Discord notifications with coordinates and light level.
- The incident is logged to the database, and the player’s VL increases based on the block’s weight.
- If the player stops suspicious mining, VL decays naturally. If it reaches a set limit, an automated command executes.
- Staff can use /vg check or /vg history to gather evidence and teleport to the location for direct observation.
Commands and Permissions at a Glance
VeinGuard’s command structure is intuitive. /vg check shows real-time mining stats, /vg history retrieves past incidents, and /vg top displays leaderboards. The patrol system is managed with /vg patrol start/stop/pause. Permissions are hierarchical: veinguard.admin grants full access, while veinguard.mod covers standard moderator needs. Notifications require veinguard.notify, and bypasses can be fine-tuned per material. All commands and permissions are documented in-game via /vg help.
Why VeinGuard Is the Smarter Anti-Xray Choice
VeinGuard respects player privacy by only tracking mining statistics for configured blocks; everything else remains invisible to staff. It avoids the performance pitfalls of ore obfuscation and instead provides actionable intelligence. The combination of real-time alerts, automated actions, and a rich investigation toolkit makes it a comprehensive solution for maintaining a fair Minecraft economy. Whether you run a small community server or a large network, VeinGuard scales with your needs and helps your staff enforce rules without constant manual oversight.