VeinGuard

插件

· 作者 JerrysPlugins

易于使用的 X 射线检测插件,可提醒工作人员注意过度挖矿。完全可配置!

0 本站下载 0 关注 更新于 5 个月前

最新 2.0.0 · 26.3 · Bukkit / Paper

一键开服(送7天)

VeinGuard Banner

Modrinth SpigotMC Hangar CurseForge bStats

Build Status


About

VeinGuard 是一款强大且轻量的反透视(anti-xray)解决方案,旨在帮助服务器管理员实时识别并监控可疑的挖掘行为。通过追踪特定方块的破坏情况并分析玩家行为,VeinGuard 提供了维持公平游戏环境所需的工具,同时不会牺牲服务器性能。

与传统的通过混淆方块来防止透视的插件不同,VeinGuard 专注于 行为检测,为工作人员提供采取行动所需的证据。


Features

?️ 核心检测与分析

  • 智能追踪: 监控特定类型的方块(由您配置),并在可自定义的时间段内计算破坏速率。
  • 违规等级(VL)系统: 根据玩家的挖掘活动为其分配“嫌疑分数”。VL 会随时间衰减,但在达到阈值时会触发自动化操作。
  • 挖掘事件模型: 将连续的警报分组为单个“事件”,以便更清晰、准确地概览挖掘会话。
  • 防垃圾信息逻辑: 每个方块或每次警报的可配置冷却时间,确保您的工作人员不会被重复通知淹没。

? 多渠道警报

  • 游戏内通知: 通过聊天栏或状态栏向在线工作人员发送即时警报。
  • Discord 集成: 无缝支持 Webhook,直接将警报记录到您的工作人员频道中。
  • 控制台日志: 详细的日志供管理审查。
  • 自动化操作: 当玩家达到特定违规阈值时,自动执行自定义命令(例如静音、冻结或踢出)。

?️ 工作人员工具与调查

  • 高级巡逻系统: 以旁观者模式循环浏览在线玩家,并带有自动用户界面和 Boss 栏追踪。
  • 详细玩家报告: 生成即时报告,显示确切的方块计数和高亮显示的违规行为。
  • 历史与排行榜: 访问持久数据库(SQLite/MySQL),查看历史挖掘数据和随时间推移的最高违规者。
  • 工作人员辅助功能: 轻松为特定玩家静音警报或切换自己的通知可见性。

⚙️ 自定义与集成

  • 动态配置: 无需重启服务器即可随时重新加载设置和语言文件。
  • 细粒度豁免: 通过权限全局或针对特定材料豁免玩家。
  • WorldGuard 支持: 使用 veinguard-check 自定义标志在特定区域启用或禁用追踪。
  • 智能过滤: 自动忽略创造模式下的玩家、特定世界中的玩家或高于定义 Y 级坐标的玩家。

Installation

? 要求

  • Java: 版本 17 或更高。
  • 平台: Spigot、Paper、Purpur (1.21+) 或任何兼容的分叉版。
  • 版本: Minecraft 1.18+ (Spigot/Paper)。

? 快速开始

  1. 下载: 从 Spigot、Modrinth、Hangar 或 GitHub 获取最新的 .jar 文件。
  2. 安装: 将文件放入服务器的 plugins/ 目录中。
  3. 初始化: 启动服务器以生成默认配置文件。
  4. 配置: 根据您的喜好调整 config.yml 和 lang.yml。
  5. 应用: 运行 /vg reload 立即应用更改。

HowToUse

? 使用方法

VeinGuard 旨在让管理员和工作人员都能直观地使用。以下是如何充分利用该插件的指南。

? 面向服务器所有者与管理员

  1. 定义追踪方块: 打开 config.yml 指定 VeinGuard 应监控的方块(例如 DIAMOND_ORE、ANCIENT_DEBRIS)。我们已提供常见方块的列表。
  2. 设置阈值: 为每个方块配置 threshold(阈值)。如果玩家在时间范围内破坏的数量超过该阈值,将触发警报。
  3. 配置自动化操作: 使用违规等级(VL)系统,当玩家达到一定可疑度时自动执行命令(例如 /kick 或 /freeze)。
  4. 管理区域: 使用 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 一个典型的检测场景:

  1. 触发条件: 玩家挖掘了一个被追踪的方块(例如钻石矿石)。VeinGuard 会立即在其内部缓存中记录此事件。
  2. 阈值检查: 如果玩家在配置的 timeframe(时间范围,例如 5 分钟)内挖掘的方块数量超过了允许值(例如 15 个钻石),则会触发警报。
  3. 数据处理:
    • 游戏内: 工作人员收到通知(聊天栏或动作栏)。
    • Discord: Webhook 会将详细信息(坐标、光照等级等)发送到您的工作人员频道。
    • 数据库: 该事件会被记录到持久化数据库(SQLite 或 MySQL)中。
  4. 违规等级(VL):
    • 每次警报都会增加玩家的 VL 分数(基于方块的“权重”)。
    • VL 衰减: 如果玩家停止可疑挖掘行为,其 VL 会随着时间自然下降。
  5. 自动化操作: 如果玩家的 VL 达到特定阈值(例如 50 VL),VeinGuard 将执行您预设的违规操作(例如 /kick 或 /freeze)。
  6. 工作人员调查:
    • 实时: 工作人员使用 /vg check <player> 查看该玩家在最近配置的时间范围内挖掘的被追踪方块总数。
    • 历史: 工作人员使用 /vg history <player> 按时间倒序回顾过去的事件,同时显示方块数量、坐标和时间戳等详细信息。
    • 裁决: 随后,工作人员可以传送至事发地点,或使用 /vg patrol 监视该玩家。

Resources

展开查看命令与权限

? 权限概览

  • 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

? 有用链接

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源