VectorGuard

插件

· 作者 NeonDev

VectorGuard 是一款 100% 服务端反作弊插件,专注于战斗检测。它采用数据包级分析、基于刻(tick)的遥测技术和多信号检测机制,以高准确率识别作弊者,并将误报率降至最低。

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

最新 1.4.0 · 1.21.11 · Folia / Paper

一键开服(送7天)

VectorGuard

适用于 Paper 服务器的生产级战斗反作弊插件。

VectorGuard 是一款 100% 服务端反作弊插件,专注于战斗检测。它利用数据包级别的分析、基于刻(tick)遥测和多信号检测技术,以高准确率和极低的误报率识别作弊者。

专为现代 Paper 服务器(1.20.x–1.21.x)及 Java 21 从头构建。


产品概览

VectorGuard 是一款仅针对战斗的反作弊系统,旨在捕获最常见的 PvP 漏洞,同时保持轻量级的性能消耗和对合法玩家的公平性。每一项检查都使用多个独立信号(旋转、时机、移动、冷却使用情况和命中验证),并应用带有衰减缓冲违规机制,因此单次突发不会惩罚正常玩家。针对高延迟玩家的 Ping 感知阈值和数据包计时补偿功能进一步降低了误报率。

管理员拥有快速响应的工作流:包含操作按钮的可点击游戏内警报、聚合跨检查风险的威胁评分,以及用于快速证据审查的可视化报告命令。内置 GUI 允许工作人员调整阈值、切换检查项和调整处罚,无需编辑文件或重启服务器。警报还可以镜像到 Discord 以便进行服务器外监控。

VectorGuard 作为单个 jar 文件发布,无外部依赖。PacketEvents 已嵌入其中,插件完全在服务端运行,无需客户端模组。


功能特性

检测引擎

  • 19 项战斗检查,针对最常见的作弊模块,包括战锤 PvP 漏洞、水晶 PvP 自动化、弓操控和库存漏洞
  • 多信号复合检测 — 每项检查结合多个独立信号以确保高置信度
  • 带可配置衰减的缓冲违规系统 — 防止单刻异常触发处罚
  • 延迟补偿 — 所有检查均考虑玩家 Ping,避免对高 Ping 玩家进行错误标记
  • 基于刻的分析 — 提供每位玩家的位置历史和旋转配置文件

管理员体验

  • 可点击的聊天警报,附带操作按钮:[TP] [VL] [DBG] [RPT]
  • 威胁评分系统 — 综合所有检查的 0–100% 风险评估
  • 可视化威胁报告,通过 /vg report <player> 查看
  • 在线管理员声音警报(可配置)
  • Discord Webhook 集成,用于服务器外监控
  • 游戏内 GUI,用于编辑阈值、切换检查项和调整处罚

架构

  • 100% 服务端 — 无需客户端模组
  • 嵌入式 PacketEvents 并已着色 — 零外部依赖
  • 模块化检查系统 — 每项检查独立且完全可配置
  • 内置性能分析器 (/vg profile)
  • 多版本支持 — Paper 1.20.x 至 1.21.x

检查项

战斗类

检查项 描述
Aimbot (自瞄) 检测与辅助瞄准一致的瞬间旋转、加速度尖峰、过度平滑曲线和精度模式
TriggerBot (连点/自动攻击) 在准星对齐后识别具有近零反应延迟的自动化攻击时机
AutoTotem (自动图腾) 在致命伤害窗口期间捕捉不切实际的副手图腾快速切换
Reach (距离/超距) 眼睛到实体盒子的距离验证,包含 Ping、冲刺和移动的宽容度
Velocity (速度/抗击退) 通过验证服务器发送的速度数据包后的位移来检测抗击退
Criticals (暴击) 通过伪造的位置数据包识别虚假暴击(异常的暴击率、地面标志振荡、微小的 Y 轴偏移)
AutoClicker (连点器) 通过时序方差分析(标准差、CPS、变异系数)捕捉机械式的点击模式
KillAura (杀戮光环) 检测多目标攻击、角度不匹配、穿墙攻击和完美的冷却滥用
Sprint (冲刺) 识别围绕攻击的回跑、KeepSprint 和冲刺切换模式
MaceSpoof (战锤伪饰) 检测为伪造战锤 smash 伤害而欺骗的下落距离位置数据包(暴击-战锤漏洞)
MaceNoFall (无摔落+战锤) 捕捉 NoFall + 战锤组合:玩家造成战锤下落加成伤害,但在落地时规避摔落伤害
MaceSwap (战锤切换) 识别在下落期间自动将武器切换为战锤的行为(属性切换 / 自动切换模式)
CrystalAura (水晶光环) 检测自动化的水晶放置与破坏循环(超人级的水晶攻击/秒数、放置→破坏配对、快速破坏比率)
BowManipulation (弓操控) 通过充能方差分析、射速和远距离异常命中率捕捉 BowSpam 和 BowAimbot
InventoryCleaner (库存清理) 识别非人类的库存操作速度(自动图腾切换、偷窃箱子物品、战斗中的库存使用)
AutoWeapon (自动换武) 检测围绕攻击的自动化武器切换(攻击前切换比率、A→B→A 切换回模式)
HitboxExpand (碰撞箱扩展) 通过横向偏移分析和边缘命中跟踪捕捉扩展的实体碰撞箱
AutoArmor (自动护甲) 检测战斗中的自动化装备穿戴(快速的护甲点击、防破损耐久度切换)

数据包类

检查项 描述
Timer (定时器) 通过数据包速率分析检测游戏速度操纵(突发、持续和平均速率监控)

要求

  • Java 21+
  • Paper 1.20.x – 1.21.x(或分支:Purpur, Pufferfish 等)
  • 无外部依赖 — PacketEvents 已嵌入

安装

  1. 下载 VectorGuard-x.y.z.jar
  2. 将其放入服务器的 plugins/ 文件夹中
  3. 启动或重启服务器
  4. 编辑 plugins/VectorGuard/config.yml 以自定义阈值
  5. 使用 /vg reload 应用更改而无需重启

命令

命令 描述
/vg reload 重新加载配置
/vg debug <player|*> 切换某位玩家(或所有玩家)的调试输出
/vg vl <player> 查看违规等级
/vg report <player> 生成可视化威胁报告
/vg gui 打开游戏内配置编辑器
/vg profile [seconds] 运行性能分析器

权限

权限 默认值 描述
vectorguard.admin op 访问所有 /vg 命令和 GUI
vectorguard.alert op 接收带有操作按钮的游戏内作弊警报
vectorguard.debug.view op 查看调试输出
vectorguard.report true 允许使用 /vg report 生成威胁报告

配置

所有设置均位于 plugins/VectorGuard/config.yml。

检查配置

每个检查项包含:

  • enabled — 开启或关闭该检查
  • buffer-threshold — 缓冲区必须超过此值才会被标记
  • buffer-decay-per-tick — 缓冲区每 tick 减少的量
  • vl-per-breach — 每次标记增加的违规等级(VL)
  • vl-decay-per-tick — VL 每 tick 减少的量
  • thresholds.* — 特定于检查的调优值

惩罚阶段

punishments:
  alert-vl: 2.5      # 向管理员发送警报
  setback-vl: 6.0     # 将玩家传送回上一个安全位置
  punish-vl: 12.0     # 执行惩罚命令
  punish-command: "kick %player% Unfair combat behavior detected by VectorGuard."

Discord Webhooks

notifications:
  discord:
    enabled: true
    webhook-url: "https://discord.com/api/webhooks/..."
    min-vl: 5.0
    cooldown-ms: 10000

管理员警报

notifications:
  admin:
    sound-enabled: true
    clickable-actions: true
    show-threat-score: true

GUI 配置编辑器

运行 /vg gui 打开交互式图形界面,您可以在其中:

  • 开启或关闭各项检查
  • 编辑缓冲区阈值和 VL 值
  • 调整惩罚阈值和冷却时间
  • 保存更改并重新加载配置

常见问题

问:这需要玩家安装任何东西吗? 答:不需要。VectorGuard 完全在服务器端运行。

问:PacketEvents 需要作为单独的插件安装吗? 答:不需要。PacketEvents 已嵌入在 VectorGuard 的 jar 包中。

问:它兼容 Purpur/Pufferfish/其他 Paper 分支吗? 答:是的,任何 Paper 分支都应该可以工作。

问:它会与其他反作弊冲突吗? 答:VectorGuard 仅专注于战斗检测。它可以与专注于移动的反作弊共存,但运行两个战斗型反作弊可能会导致重复标记。

问:如何减少误报? 答:增加正在错误标记的检查项的 buffer-threshold 和 ping-cutoff-ms 值。默认值经过保守调优。


致谢

由 Mr. Dev 创建


许可协议

版权所有 (c) 2025 NeonDev。保留所有权利。

本软件及其源代码均为 NeonDev 的独家财产。

未经版权所有者事先书面许可,不得出于任何目的使用、复制、修改、合并、发布、分发、再许可、出售或以其他方式利用本软件的任何部分,包括但不限于源代码、编译后的二进制文件、文档、配置文件或任何相关资产。

未经授权而使用、复制或分发本软件或其任何部分均属严格禁止,并可能导致民事和刑事处罚。

本软件按“原样”提供,不提供任何形式的明示或暗示保证,包括但不限于对适销性、特定用途适用性和非侵权性的保证。在任何情况下,作者均不对因使用本软件或与本软件相关的任何其他事宜而引起的任何索赔、损害或其他责任负责,无论是基于合同、侵权行为还是其他原因。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源