
VeinGuard 是一款强大且轻量的反透视(anti-xray)解决方案,旨在帮助服务器管理员实时识别并监控可疑的挖掘行为。通过追踪特定方块的破坏情况并分析玩家行为,VeinGuard 提供了维持公平游戏环境所需的工具,同时不会牺牲服务器性能。
与传统的通过混淆方块来防止透视的插件不同,VeinGuard 专注于 行为检测,为工作人员提供采取行动所需的证据。

?️ 核心检测与分析
- 智能追踪: 监控特定类型的方块(由您配置),并在可自定义的时间段内计算破坏速率。
- 违规等级(VL)系统: 根据玩家的挖掘活动为其分配“嫌疑分数”。VL 会随时间衰减,但在达到阈值时会触发自动化操作。
- 挖掘事件模型: 将连续的警报分组为单个“事件”,以便更清晰、准确地概览挖掘会话。
- 防垃圾信息逻辑: 每个方块或每次警报的可配置冷却时间,确保您的工作人员不会被重复通知淹没。
? 多渠道警报
- 游戏内通知: 通过聊天栏或状态栏向在线工作人员发送即时警报。
- Discord 集成: 无缝支持 Webhook,直接将警报记录到您的工作人员频道中。
- 控制台日志: 详细的日志供管理审查。
- 自动化操作: 当玩家达到特定违规阈值时,自动执行自定义命令(例如静音、冻结或踢出)。
?️ 工作人员工具与调查
- 高级巡逻系统: 以旁观者模式循环浏览在线玩家,并带有自动用户界面和 Boss 栏追踪。
- 详细玩家报告: 生成即时报告,显示确切的方块计数和高亮显示的违规行为。
- 历史与排行榜: 访问持久数据库(SQLite/MySQL),查看历史挖掘数据和随时间推移的最高违规者。
- 工作人员辅助功能: 轻松为特定玩家静音警报或切换自己的通知可见性。
⚙️ 自定义与集成
- 动态配置: 无需重启服务器即可随时重新加载设置和语言文件。
- 细粒度豁免: 通过权限全局或针对特定材料豁免玩家。
- WorldGuard 支持: 使用
veinguard-check自定义标志在特定区域启用或禁用追踪。 - 智能过滤: 自动忽略创造模式下的玩家、特定世界中的玩家或高于定义 Y 级坐标的玩家。

? 要求
- Java: 版本 17 或更高。
- 平台: Spigot、Paper、Purpur (1.21+) 或任何兼容的分叉版。
- 版本: Minecraft 1.18+ (Spigot/Paper)。
? 快速开始
- 下载: 从 Spigot、Modrinth、Hangar 或 GitHub 获取最新的
.jar文件。 - 安装: 将文件放入服务器的
plugins/目录中。 - 初始化: 启动服务器以生成默认配置文件。
- 配置: 根据您的喜好调整
config.yml和lang.yml。 - 应用: 运行
/vg reload立即应用更改。

? 使用方法
VeinGuard 旨在让管理员和工作人员都能直观地使用。以下是如何充分利用该插件的指南。
? 面向服务器所有者与管理员
- 定义追踪方块: 打开
config.yml指定 VeinGuard 应监控的方块(例如DIAMOND_ORE、ANCIENT_DEBRIS)。我们已提供常见方块的列表。 - 设置阈值: 为每个方块配置
threshold(阈值)。如果玩家在时间范围内破坏的数量超过该阈值,将触发警报。 - 配置自动化操作: 使用违规等级(VL)系统,当玩家达到一定可疑度时自动执行命令(例如
/kick或/freeze)。 - 管理区域: 使用 WorldGuard 标志(
veinguard-check: deny)在公共矿洞或其他不应追踪玩家的区域禁用追踪功能。
? 面向工作人员与版主
- 监控警报: 留意游戏内聊天或 Discord 中的通知。警报会将连续的破坏行为合并为“事件”,以防止刷屏。
- 实时调查: 使用
/vg check <player>查看某玩家的近期挖掘活动及当前的破坏速率。 - 回顾历史: 使用
/vg history <player>从数据库中调取历史记录,即使玩家离线也能查看。 - 主动巡逻: 使用
/vg patrol start以旁观者模式自动循环检查在线玩家。Boss Bar 会随时向您通报他们的状态。 - 管理通知: 如果您忙碌,可使用
/vg toggle-alerts隐藏通知;或使用/vg mute <player>静音特定(受信任的)用户。
? 面向玩家
- 公平游戏: 正常游玩即可!VeinGuard 旨在忽略正常的挖掘模式,仅标记高度可疑且重复的行为。
- 隐私保护: 工作人员只能查看被追踪方块的挖掘统计数据;您的其他活动保持私密。
? 挖掘事件解析
为了更好地理解 VeinGuard 如何保护您的服务器,让我们 walkthrough 一个典型的检测场景:
- 触发条件: 玩家挖掘了一个被追踪的方块(例如钻石矿石)。VeinGuard 会立即在其内部缓存中记录此事件。
- 阈值检查: 如果玩家在配置的
timeframe(时间范围,例如 5 分钟)内挖掘的方块数量超过了允许值(例如 15 个钻石),则会触发警报。 - 数据处理:
- 游戏内: 工作人员收到通知(聊天栏或动作栏)。
- Discord: Webhook 会将详细信息(坐标、光照等级等)发送到您的工作人员频道。
- 数据库: 该事件会被记录到持久化数据库(SQLite 或 MySQL)中。
- 违规等级(VL):
- 每次警报都会增加玩家的 VL 分数(基于方块的“权重”)。
- VL 衰减: 如果玩家停止可疑挖掘行为,其 VL 会随着时间自然下降。
- 自动化操作: 如果玩家的 VL 达到特定阈值(例如 50 VL),VeinGuard 将执行您预设的违规操作(例如
/kick或/freeze)。 - 工作人员调查:
- 实时: 工作人员使用
/vg check <player>查看该玩家在最近配置的时间范围内挖掘的被追踪方块总数。 - 历史: 工作人员使用
/vg history <player>按时间倒序回顾过去的事件,同时显示方块数量、坐标和时间戳等详细信息。 - 裁决: 随后,工作人员可以传送至事发地点,或使用
/vg patrol监视该玩家。
- 实时: 工作人员使用

展开查看命令与权限
? 权限概览
veinguard.admin— 完全访问所有插件功能和命令。veinguard.mod— 标准版主权限。包括:veinguard.notify,veinguard.bypass,veinguard.command.check,veinguard.command.help,veinguard.command.history,veinguard.command.top,veinguard.command.toggle-alerts,veinguard.command.tracked-blocks.list.
veinguard.notify— 接收游戏内警报通知。veinguard.bypass— 完全豁免追踪。veinguard.bypass.[MATERIAL]— 针对特定方块的豁免(例如veinguard.bypass.DIAMOND_ORE)。veinguard.unmute— 解禁玩家的权限。veinguard.resetall— 重置所有玩家追踪记录的权限。veinguard.update— 加入服务器时接收更新通知。
? 命令
| 命令 | 权限 | 描述 | 用法示例 |
|---|---|---|---|
/vg help [page] |
veinguard.command.help |
显示所有可用命令及其用法的详细列表。 | /vg help 2 |
/vg check <player> |
veinguard.command.check |
打开玩家最近采矿活动的实时报告,包括精确的方块数量。 | /vg check Notch |
/vg history <player> [time] |
veinguard.command.history |
从数据库中检索历史采矿事件,以便调查离线玩家。 | /vg history Notch 24h |
/vg top [time] |
veinguard.command.top |
显示违规等级最高、方块数量最多以及触发警报总数最多的玩家排行榜。 | /vg top 7d |
/vg patrol <action> |
veinguard.command.patrol |
管理自动员工巡逻:start(开始)、stop(停止)、pause(暂停)、resume(恢复)、next(下一个)或 back(上一个)。 |
/vg patrol start |
/vg msg <player> <msg> |
veinguard.command.msg |
向玩家发送格式化的插件消息(用于自动化违规处理操作)。 | /vg msg Notch Fair play only! |
/vg staffmsg <msg> |
veinguard.command.staffmsg |
向所有拥有通知权限的员工广播一条管理消息。 | /vg staffmsg Checking Notch. |
/vg mute <player> |
veinguard.command.mute |
静音特定玩家的所有未来警报通知(例如针对受信任的成员)。 | /vg mute Notch |
/vg unmute <player> |
veinguard.command.unmute |
恢复之前被静音玩家的警报通知。 | /vg unmute Notch |
/vg toggle-alerts [player] |
veinguard.command.toggle-alerts |
切换你自己的警报可见性,或为其他员工管理此设置。 | /vg toggle-alerts |
/vg tracked-blocks <add/list/remove> |
veinguard.command.tracked-blocks.[add/list/remove] |
实时管理系统正在监控哪些方块。 | /vg tracked-blocks add DIAMOND_ORE 15 Diamond Ore |
/vg reload |
veinguard.command.reload |
热重载所有配置文件和语言文件,无需重启服务器。 | /vg reload |
/vg reset <player> |
veinguard.command.reset |
完全清除特定玩家当前的破坏历史和违规等级 (VL)。 | /vg reset Notch |
/vg resetall |
veinguard.command.resetall |
同时清除所有在线玩家的活跃跟踪数据和 VL 分数。 | /vg resetall |
/vg purge <time> [player] |
veinguard.command.purge |
手动从数据库中删除旧的历史数据以保持数据库优化。 | /vg purge 30d |
? 有用链接
- ? Documentation & Wiki: 详细指南和配置帮助。
- ? Issue Tracker: 报告错误或建议新功能。
- ? Discord Support: 获取帮助并了解最新动态。
- ? Plugin Metrics: 查看我们的匿名使用统计数据。

VeinGuard is a robust, lightweight anti-xray solution designed to help server administrators identify and monitor suspicious mining patterns in real-time. By tracking specific block breaks and analyzing player behavior, VeinGuard provides the tools necessary to maintain a fair gaming environment without compromising server performance.
Unlike traditional anti-xray plugins that obfuscate blocks, VeinGuard focuses on behavioral detection, giving staff the evidence they need to take action.

?️ Core Detection & Analysis
- Intelligent Tracking: Monitors specific block types (configured by you) and calculates break rates over customizable timeframes.
- Violation Level (VL) System: Assigns a "suspicion score" to players based on their mining activity. VL decays over time but triggers automated actions when thresholds are met.
- Mining Incident Model: Groups consecutive alerts into single "incidents" for a cleaner, more accurate overview of mining sessions.
- Anti-Spam Logic: Configurable cooldowns per block or per alert ensure your staff aren't overwhelmed by repetitive notifications.
? Multi-Channel Alerts
- In-Game Notifications: Instant alerts via Chat or Action Bar for online staff.
- Discord Integration: Seamless webhook support to log alerts directly to your staff channels.
- Console Logging: Detailed logs for administrative review.
- Automated Actions: Execute custom commands (e.g., mute, freeze, or kick) automatically when a player reaches a specific violation threshold.
?️ Staff Tools & Investigation
- Advanced Patrol System: Cycle through online players in Spectator mode with an automated UI and boss bar tracking.
- Detailed Player Reports: Generate instant reports showing exact block counts and highlighted violations.
- History & Leaderboards: Access a persistent database (SQLite/MySQL) to view historical mining data and top violators over time.
- Staff Utility: Easily mute alerts for specific players or toggle your own notification visibility.
⚙️ Customization & Integration
- Dynamic Configuration: Reload settings and language files on-the-fly without restarting the server.
- Granular Bypasses: Exempt players via permissions globally or for specific materials.
- WorldGuard Support: Use the
veinguard-checkcustom flag to enable or disable tracking in specific regions. - Smart Filtering: Automatically ignores players in Creative mode, specific worlds, or above a defined Y-level.

? Requirements
- Java: Version 17 or newer.
- Platform: Spigot, Paper, Purpur (1.21+), or any compatible fork.
- Version: Minecraft 1.18+ (Spigot/Paper).
? Quick Start
- Download: Grab the latest
.jarfrom Spigot, Modrinth, Hangar, or GitHub. - Install: Drop the file into your server's
plugins/directory. - Initialize: Start the server to generate the default configuration files.
- Configure: Adjust
config.ymlandlang.ymlto your preference. - Apply: Run
/vg reloadto apply changes instantly.

? How to Use
VeinGuard is designed to be intuitive for both administrators and staff. Below is a guide on how to get the most out of the plugin.
? For Server Owners & Admins
- Define Tracked Blocks: Open
config.ymlto specify which blocks VeinGuard should monitor (e.g.,DIAMOND_ORE,ANCIENT_DEBRIS). We have already provided a list of common blocks. - Set Thresholds: Configure the
thresholdfor each block. If a player breaks more than the threshold within the timeframe, an alert is triggered. - Configure Automated Actions: Use the Violation Level (VL) system to execute commands automatically (e.g.,
/kickor/freeze) when a player reaches a certain suspicion level. - Manage Regions: Use WorldGuard flags (
veinguard-check: deny) to disable tracking in areas like public mines or other areas where a player shouldn't be tracked.
? For Staff & Moderators
- Monitor Alerts: Keep an eye on in-game chat or Discord. Alerts group consecutive breaks into "Incidents" to prevent spam.
- Real-Time Investigation: Use
/vg check <player>to see a player's recent mining activity and current break rates. - Review History: Use
/vg history <player>to pull historical data from the database, even if the player is offline. - Active Patrol: Use
/vg patrol startto automatically cycle through online players in Spectator mode. The Boss Bar will keep you informed of their status. - Manage Notifications: Use
/vg toggle-alertsto hide notifications if you're busy, or/vg mute <player>to silence a specific (trusted) user.
? For Players
- Fair Play: Just play normally! VeinGuard is designed to ignore natural mining patterns and only flags highly suspicious, repetitive behavior.
- Privacy: Staff can only see mining statistics for tracked blocks; your other activities remain private.
? Anatomy of a Mining Incident
To better understand how VeinGuard protects your server, let's walk through a typical detection scenario:
- The Trigger: A player mines a tracked block (e.g., Diamond Ore). VeinGuard immediately records this event in its internal cache.
- Threshold Check: If the player mines more blocks than allowed within your configured
timeframe(e.g., 15 diamonds in 5 minutes), an Alert is triggered. - Data Processing:
- In-Game: Staff receive a notification (Chat or Action Bar).
- Discord: A webhook sends detailed info (coordinates, light level, etc.) to your staff channel.
- Database: The incident is logged to the persistent database (SQLite or MySQL).
- Violation Levels (VL):
- Each alert adds to the player's VL score (based on the block's "weight").
- VL Decay: If the player stops mining suspiciously, their VL will naturally decrease over time.
- Automated Action: If the player's VL reaches a specific threshold (e.g., 50 VL), VeinGuard executes your pre-defined Violation Action (e.g.,
/kickor/freeze). - Staff Investigation:
- Real-time: Staff use
/vg check <player>to see the total number of tracked blocks they've mined in the last configured timeframe. - History: Staff use
/vg history <player>to review past incidents starting with the most recent, also displaying details such as block counts, coordinates, and timestamps. - Verdict: Staff can then teleport to the location or use
/vg patrolto monitor the player.
- Real-time: Staff use

Expand for Commands & Permissions
? Permissions Overview
veinguard.admin— Full access to all plugin features and commands.veinguard.mod— Standard moderator access. Includes:veinguard.notify,veinguard.bypass,veinguard.command.check,veinguard.command.help,veinguard.command.history,veinguard.command.top,veinguard.command.toggle-alerts,veinguard.command.tracked-blocks.list.
veinguard.notify— Receive in-game alert notifications.veinguard.bypass— Complete exemption from tracking.veinguard.bypass.[MATERIAL]— Exemption for a specific block (e.g.,veinguard.bypass.DIAMOND_ORE).veinguard.unmute— Permission to unmute players.veinguard.resetall— Permission to reset tracking for all players.veinguard.update— Receive update notifications on join.
? Commands
| Command | Permission | Description | Example Usage |
|---|---|---|---|
/vg help [page] |
veinguard.command.help |
Displays a detailed list of all available commands and their usage. | /vg help 2 |
/vg check <player> |
veinguard.command.check |
Opens a real-time report of a player's recent mining activity, including exact block counts. | /vg check Notch |
/vg history <player> [time] |
veinguard.command.history |
Retrieves historical mining incidents from the database for investigation of offline players. | /vg history Notch 24h |
/vg top [time] |
veinguard.command.top |
Displays a leaderboard of players with the highest violation levels, block counts, and total alerts triggered. | /vg top 7d |
/vg patrol <action> |
veinguard.command.patrol |
Manage the automated staff patrol: start, stop, pause, resume, next, or back. |
/vg patrol start |
/vg msg <player> <msg> |
veinguard.command.msg |
Sends a formatted plugin message to a player (useful for automated violation actions). | /vg msg Notch Fair play only! |
/vg staffmsg <msg> |
veinguard.command.staffmsg |
Broadcasts an administrative message to all staff members with notification permissions. | /vg staffmsg Checking Notch. |
/vg mute <player> |
veinguard.command.mute |
Silences all future alert notifications for a specific player (e.g., for trusted members). | /vg mute Notch |
/vg unmute <player> |
veinguard.command.unmute |
Restores alert notifications for a previously muted player. | /vg unmute Notch |
/vg toggle-alerts [player] |
veinguard.command.toggle-alerts |
Toggles your own alert visibility or manages it for another staff member. | /vg toggle-alerts |
/vg tracked-blocks <add/list/remove> |
veinguard.command.tracked-blocks.[add/list/remove] |
Real-time management of which blocks are being monitored by the system. | /vg tracked-blocks add DIAMOND_ORE 15 Diamond Ore |
/vg reload |
veinguard.command.reload |
Hot-reloads all configuration and language files without requiring a server restart. | /vg reload |
/vg reset <player> |
veinguard.command.reset |
Completely clears a specific player's current break history and Violation Level (VL). | /vg reset Notch |
/vg resetall |
veinguard.command.resetall |
Wipes active tracking data and VL scores for all online players simultaneously. | /vg resetall |
/vg purge <time> [player] |
veinguard.command.purge |
Manually removes old historical data from the database to keep it optimized. | /vg purge 30d |
? Useful Links
- ? Documentation & Wiki: Detailed guides and configuration help.
- ? Issue Tracker: Report bugs or suggest new features.
- ? Discord Support: Get help and stay updated.
- ? Plugin Metrics: View our anonymous usage statistics.
下载 VeinGuard
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VeinGuard
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VeinGuard
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VeinGuard
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VeinGuard
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VeinGuard
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VeinGuard
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VeinGuard
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VeinGuard
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VeinGuard
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
- 违规等级(VL)系统:一种基于嫌疑度的评分系统,可追踪玩家行为并在规定阈值触发时执行自动化操作。
- 挖掘事件模型:智能告警分组功能,将连续的违规行为合并为单次会话,从而生成更清晰的日志并提高调查准确性。
- 新的调查命令:
/vg history <player>:查看指定玩家在持久化数据库中的历史挖掘会话。/vg top:查看服务器上最活跃/最具可疑性的玩家排行榜。/vg purge:通过删除旧的历史记录轻松管理数据库大小。/vg staffmsg:与其他管理人员即时协调沟通。
- MySQL 与 MariaDB 支持:在标准 SQLite 之外提供完整的 MySQL 支持,实现整个服务器网络中挖掘数据的同步。
- Discord 集成:改进了 Webhook 的可靠性,增加了安全的数据转义处理和详细的告警格式。
- 自动数据库清理:新增后台任务,自动保持数据库处于优化状态。
- 游戏内管理:直接通过命令添加、移除或列出受监控的方块,并管理倍率。
- 性能优化:采用异步日志记录和数据库操作,确保对服务器 TPS 零影响。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧